Readme redistribution version 11 ActiveX/COM

VDF Components Redistribution !

Application Redistribution - for VectorDraw Dev. Framework version 11.x and later

All our managed DLLs now are in AnyCPU build and just some unmanaged DLLs are x86 and x64 and are loaded dynamically. Also now we provide 2 different MergeModules that contain our dlls and can be used in your setup projects for COM/ActiveX applications. The Icons (*.ico) where removed from these merge modules as the icons are now added to the dll's resources. Please read below the new procedures you should follow:

Using vdraw.ocx and/or vdgrid.ocx ActiveX Wrapper components

Distribute using a Setup Deployment (Merge Modules)

Based on our experience and testing we have created the following redistribution guide that will allow our libraries to be installed successfully into a system. We will not be able to support setup projects that do not follow these instructions and do not contain the mentioned required packages.Any difficulty encountered by third party setup applications (for example not supporting merge modules) should be addressed to the developer of the mentioned setup application.

  • Add your application, referencing VectorDraw Components, in the Application Folder of your setup project and the .vdlic file that is created by vdLic.exe application during build.
  • If you are using VectorDraw Custom objects in a separate dll, add this dll in the same folder as your application or in a separate folder, after setting the SupportPath property of the vdDocument object in the application's source code to the dll's folder full path
  • If you are using the Customized Dialog/Icons/Menu/Commands globalization add the necessary vdres.txt, menu.txt, commands.txt, vdFormRes.dll in the same folder as your application or in a separate folder, after setting the SupportPath property of the vdDocument object in the application's source code to the folder's full path

Note: Do not add any of the VectorDraw dll references in your setup. If the setup adds them automatically in the "Detected Dependencies" you should exclude them all as these dlls are inside the merge module we provide; VectorDraw References will be automatically added in the Detected Dependencies of your setup project.

  • Select all of the following VectorDraw dlls that were automatically added in the Detected Dependencies and set their property Exclude, to True. Detected VectorDraw Components may be one or more of the following:

OpenVDF.dll
RenderFormats.dll
vdCommandLine.dll
vdCommandLine.tlb
vdDxf.dll
vdFramedControl.dll
vdgrid.ocx
vDgridLib.dll
pvengine.dll
AxVdgridlib.dll
vdProControl.dll
vdPropertyGrid.dll
vdPropertyGrid.tlb
vDrawBaseControl.dll
vdraw.ocx
AxVdrawlib5.dll
Vdrawlib5.dll
vdrawI5.dll
VdrawI5.tlb
vdrawPro5.dll
vdrawPro5.tlb
vdScrollableControl.dll
vdScrollableControl.tlb
vdxFcnv.dll
slapi.dll
SketchUpAPI.dll/SketchUpCommonPreferences.dll
VectorDraw_ploffset.dll
vdxFilesx86.dll/vdxFilesx64.dll
xFiles_pdf.dll/xFiles_pdf64.dll
vdxFcnv.dll
vdrawgl.dll
vdray.dll     
vdIFC.dll     
vdfOpen.dll/vdfOpen64.dll
VectorDraw.Actions.dll
VectorDraw.Actions.tlb
VectorDraw.Fonts.dll
VectorDraw.Generics.dll
VectorDraw.Geometry.dll
VectorDraw.Geometry.tlb
VectorDraw.Professional.dll
VectorDraw.Professional.tlb
VectorDraw.Render.dll
VectorDraw.Render.tlb
VectorDraw.SolidModel.dll
VectorDraw.Serialize.dll
VectorDraw.Serialize.tlb

  • In Solution Explorer right-click on your setup project and Select Add Merge Module and select theVDFDevModule.msmand VDFComModule.msm(VectorDraw COM  Framework Module) that you got from our website.
  • In MergeModuleProperties of the  VDFDevModule.msmand  VDFComModule.msmmerge module select Module Retargetable Folder property same as yourApplication.exe
  • Add to your Setup Project's Prerequisities the:Visual C++ (2015-2022) "14" Runtime Libraries (x86) RedistributablesandVisual C++ (2015-2022) "14"  Runtime Libraries (x64) Redistributables  if your setup targets x64 systems OR just theVisual C++ (2015-2022) "14" Runtime Libraries (x86) Redistributablesif your setup targets x86 systems.
  • In your setup project properties make sure that you have selected the .NET Framework 3.5 SP1  and also your .NET framework you used to build your application in the Prerequisites of your setup. .NET 3.5 SP1 is necessary!
  • While you build your setup project you may get some warnings like :
       Warning 22 Two or more objects have the same target location ('[payload]\msvcp90.dll') C:\testSetup\SetupA1.vdproj 
       Warning 38 Two or more objects have the same target location ('[payload_ul]\9.0.30729.4148.cat') C:\testSetup\SetupA1.vdproj

    Ignore these warnings as they wont produce any problem to the setup or to your application.
  • In 32bit (x86) machines only the x86 versions of  VS C++ (2015-2022) "14" Runtime are needed.

Distribution using Side by Side (SxS), single xcopy command IS NOT SUPPORTED for COM/ActiveX applications.
  
Custom Objects, Custom DLLs : If your project contains custom object dlls then in your setup project add your custom dlls there in the same folder as the Module Retargetable Folder you chose for the two MSMs.  This is because these dlls must be in the same folder as the VDF dlls (like VectorDraw.Professional.dll etc.)
 

 Note: The VDF merge modules and the vdAnyCPUSxS.zip files are available ONLY to registered VDF subscribers and not for evaluators


.DWG/.DGN File Support

If you need DWG/DGN support in your application, then you need to redistribute the FileConverters Full/Lite setup along with your setup, "as is" as provided by us, so the user reads and accepts the EULA of FileConverter. If you are member of the OpenDesign Alliance this is not necessary, just email us in order to provide you the extra information you need for redistributing OpenDesign's Teigha libraries with your setup.