Image Properties

These properties configure the images. Most of these properties are set in emxComponents.properties.

Note: Thumbnails are not generated for images with more than 268,435,456 pixels.

This page discusses:

emxComponents.properties

If you want to change the default values, enter your changes in the emxComponent.properties page object. For more information, see Editing Properties Using MQL.

Property Name Property Description Valid Values
emxComponents.ImageManager.AllowedFormats Defines the allowable image formats system-wide for both 2D and 3D files.

The default Java image utility supports these formats: gif, giff, jpg, jpeg, and png, plus svg vector graphic format on Windows-based servers. This property can be changed according to the utility tool used to generate thumbnails and different sized images.

The image utility does not support the PDF format.

Comma-separated list of image file formats
emxComponents.ImageManager.ImageUtility.Directory Defines the directory path where image utility is installed. Use the forward slash as a directory separator.

If this property is empty, the app uses the Java image utility. To support additional formats, ImageMagick or nConvert can be used (currently the only image utilities supported).

NConvert can be used to covert PDF files, however, Ghost Script must be installed on the system.

To generate thumbnails, you also need to install these third-party plug-ins (for Windows only) in the NConvert plugins folder (default is C:\nConvert\Plugins):

  • cs_svg.dll: converts svg to jpeg. Download from http://www.cadsofttools.com/en/documents/ downloads.html
  • xswf.usr: converts swg to jpeg. Download from http://www.cherubicsoft.com/xnview/.

Internet Explorer users need to install browser plug-ins for viewing SVG files.

You must also specify the name of the image converter in the next property.

Directory path
emxComponents.ImageManager.ImageUtility.Name Defines the image converter. The value can be either ImageMagick.exe or nConvert.exe. If you do not use one of these utilities, leave the value for this property blank. Executable file name
emxComponents.ImageUtility.Transparency.nConvert When true, preserves the transparency of PNG images when using nConvert. When false, transparency, which is not supported by the JPEG format (default for image conversion) is not preserved.

If your system does not use nConvert, this property is ignored.

True or False
emxComponents.ImageManager.ViewerThumbnailFormat Defines the format used to generate thumbnail images for an image. The default size of these images are:
  • format_mxSmallImage - 64 pixels
  • format_mxMediumImage - 102 pixels
  • format_mxLargeImage - 480 pixels
  • format_mxThumbnailImage - 45 pixels

These default values can be changed by editing the mxImageSize administrative property on the Format.

One of the following:
  • format_mxSmallImage
  • format_mxMediumImage
  • format_mxLargeImage
  • format_mxThumbnailImage
emxComponents.3DXML.AltPath.<OBJECT_TYPE> Defines the full path expression to find an object that contains images external to the Image Holder object (an alternate path to the image), where <OBJECT_TYPE> is the symbolic name of an object type.

This property value can be empty, and can be a comma-separated list of expressions. For example, the alternate path can be used to get 2D or 3D images from X-CAD Design Management added to the part as a specification, not as an image. If a subtype is not defined, the parent type will be used.

For example: emxComponents.3DXML.AltPath.type_Part = $id,$from[Part Specification].to.id,$from[Part Specification].to.from[Active Version].to.id

Empty, or a comma-separated list of expressions
emxComponents.3DXML.AltPath3DXMLFormat.<OBJECT_TYPE> If the AltPath property is used, define an MQL expression for the relationship between the image and the object for these properties for each <OBJECT_TYPE>.

For example: emxComponents.3DXML.AltPath.type_Part=from [$relationship_PartSpecification].to.from[$relationship_ActiveVersion] .to.from[$relationship_Viewable].to.id

When AltPath is used and there are multiple images checked into the configured formats, the app uses this precedence to select the primary image:

  • 3DXML format
  • CGR format
  • Image format

Empty, or a comma-separated list of expressions
emxComponents.3DXML.AltPathCGRFormat.<OBJECT_TYPE>
emxComponents.3DXML.AltPathImageFormat.<OBJECT_TYPE>
emxComponents.3DXML.AltPath.<OBJECT_TYPE> Associates images with a company by defining an expression for an alternate path to the image, where <OBJECT_TYPE> is the symbolic name of an object type. Expression
emxComponents.3DXML.AltPathImageFormat.<OBJECT_TYPE> Defines the format where the images above are checked in, where <OBJECT_TYPE> is the symbolic name of an object type. For example: emxComponents.3DXML.AltPathImageFormat.type_Company=format_generic emxComponents.3DXML.AltPath3DXMLFormat.type_Company=format_generic emxComponents.3DXML.AltPathCGRFormat.type_Company=format_generic Symbolic name of format
emxComponents.3DXML.AltPath3DXMLFormat.<OBJECT_TYPE> Symbolic name of format
emxComponents.3DXML.AltPathCGRFormat.<OBJECT_TYPE> Symbolic name of format
emxComponents.3DXML.AltPath3DXMLFormat.<OBJECT_TYPE> Defines the formats in which CAD files are checked into the alternate path object, where <OBJECT_TYPE> is the symbolic name of an object type.

If you specified a value for the above property, emxComponents.3DXML.AltPath.<OBJECT_TYPE>, you need to specify the corresponding format for the image type.

Symbolic name of format
emxComponents.3DXML.AltPathCGRFormat.<OBJECT_TYPE> Defines the formats in which CGR files are checked into the alternate path object, where <OBJECT_TYPE> is the symbolic name of an object type. Symbolic name of format
emxComponents.3DXML.AltPathImageFormat.<OBJECT_TYPE> Defines the formats in which 3DXML files are checked into the alternate path object, where <OBJECT_TYPE> is the symbolic name of an object type. Symbolic name of format
emxComponents.3DXML.CADFormats.Extensions Defines the CAD formats allowed to be checked in. For example: emxComponents.3DXML.CADFormats.Extensions=3dxml, cgr,gif,jpg,bmp,png File extension
emxComponents.3DXML.DefaultImage Defines the default image name displayed as a thumbnail for 3DXML and CGR files when the file does not contain its own thumbnail. For example: emxComponents.3DXML.DefaultImage=Sample.jpg Text string
emxComponents.ImageManager.2DImageFormats Defines the 2D formats allowed to be checked in. For example: emxComponents.ImageManager.2DImageFormats=gif,jpg,png,giff,jpeg File extension
emxComponents.ImageManager.MaxTimeToWaitForImageConversion Defines the maximum time (in seconds0 to wait for image conversion using ImageMagick or nConvert tools. Positive integer
emxComponents.ImageManager.ImageConversionAtFCS Defines whether image conversion is executed at the FCS (true) or MCS (false). True or False

emxTeamCentral.properties

If you want to change the default values, enter your changes in the emxTeamCentral.properties page object. For more information, see Editing Properties Using MQL.

Property Name Property Description Valid Values
emxTeamCentral.ImageCheckin When false, removes the fields that let users specify image files for a Company, Bookmark Root, and Person. True or False