The AnnotationKit class is a user space object. More...
#include <sprk_publish.h>
Public Member Functions | |
AnnotationKit () | |
The default constructor creates an empty AnnotationKit object. More... | |
AnnotationKit (AnnotationKit const &in_kit) | |
The copy constructor creates a new AnnotationKit object that contains the same settings as the source AnnotationKit. More... | |
AnnotationKit (AnnotationKit &&in_kit) | |
The move constructor creates an AnnotationKit by transferring the underlying object of the rvalue reference to this AnnotationKit. More... | |
virtual | ~AnnotationKit () |
HPS::Type | ObjectType () const |
void | Set (AnnotationKit const &in_kit) |
Copies the source AnnotationKit into this AnnotationKit. More... | |
void | Show (AnnotationKit &out_kit) const |
Copies this AnnotationKit into the given AnnotationKit. More... | |
AnnotationKit & | operator= (AnnotationKit const &in_kit) |
Copies the source AnnotationKit into this AnnotationKit. More... | |
AnnotationKit & | operator= (AnnotationKit &&in_kit) |
The move assignment operator transfers the underlying object of the rvalue reference to this AnnotationKit. More... | |
bool | Empty () const |
Indicates whether this AnnotationKit has any values set on it. More... | |
bool | Equals (AnnotationKit const &in_kit) const |
Check if the source AnnotationKit is equivalent to this AnnotationKit. More... | |
bool | operator== (AnnotationKit const &in_kit) const |
Check if the source AnnotationKit is equivalent to this AnnotationKit. More... | |
bool | operator!= (AnnotationKit const &in_kit) const |
Check if the source AnnotationKit is not equivalent to this AnnotationKit. More... | |
AnnotationKit & | SetSource (CADModel const &in_cad_model) |
Sets the source for the annotation to Annotation::SourceType::CADModel. More... | |
AnnotationKit & | SetSource (KeyPathArray const &in_sources) |
Sets the source for the annotation to Annotation::SourceType::KeyPaths. More... | |
AnnotationKit & | SetSource (size_t in_count, KeyPath const in_sources[]) |
Sets the source for the annotation to Annotation::SourceType::KeyPaths. More... | |
AnnotationKit & | SetSource (KeyPath const &in_source) |
Sets the source for the annotation to Annotation::SourceType::KeyPaths. More... | |
AnnotationKit & | SetSource (CADModel const &in_cad_model, KeyPathArray const &in_additional_sources) |
Sets the source for the annotation to Annotation::SourceType::CADModelAndKeyPaths. More... | |
AnnotationKit & | SetSource (CADModel const &in_cad_model, size_t in_count, KeyPath const in_additional_sources []) |
Sets the source for the annotation to Annotation::SourceType::CADModelAndKeyPaths. More... | |
AnnotationKit & | SetFormat (Annotation::Format in_format) |
Sets the format of the 3D data for the annotation. More... | |
AnnotationKit & | SetPRCTessellationCompression (bool in_state) |
Sets whether to compress tessellation for a PRC annotation. More... | |
AnnotationKit & | SetPRCBRepCompression (PRC::BRepCompression in_level) |
Sets the level of compression to apply to BRep data for a PRC annotation. More... | |
AnnotationKit & | SetPRCBRepRemoval (bool in_state) |
Sets whether to remove the BRep information in the PRC data for this annotation. More... | |
AnnotationKit & | SetPRCAttributeRemoval (bool in_state) |
Sets whether to remove the attribute information in the PRC data for this annotation. More... | |
AnnotationKit & | SetU3DVersion (U3D::Version in_version) |
Sets the version of the data for a U3D annotation. More... | |
AnnotationKit & | SetU3DCompression (unsigned char in_level) |
Sets the level of compression to apply to tessellations for a U3D annotation. More... | |
AnnotationKit & | SetName (char const *in_name) |
Sets the name for the annotation. More... | |
AnnotationKit & | SetArtwork (ArtworkKit const &in_artwork) |
Sets the artwork for the annotation. More... | |
AnnotationKit & | SetActivation (Activation::When in_when) |
Sets when the annotation is activated. More... | |
AnnotationKit & | SetDeactivation (Deactivation::When in_when) |
Sets when the annotation is deactivated. More... | |
AnnotationKit & | SetToolbarVisibility (bool in_state) |
Sets whether to display the toolbar when the annotation is activated. More... | |
AnnotationKit & | SetModelTreeVisibility (bool in_state) |
Sets whether to display the model tree when the annotation is activated. More... | |
AnnotationKit & | SetInteractivity (bool in_state) |
Sets whether to enable interactivity on the annotation. More... | |
AnnotationKit & | SetBorderWidth (int in_width) |
Sets the border width in points for the annotation. More... | |
AnnotationKit & | SetTransparentBackground (bool in_state) |
Sets whether the annotation background is transparent. More... | |
AnnotationKit & | SetBackgroundColor (RGBColor const &in_color) |
Sets the background color for the annotation. More... | |
AnnotationKit & | SetLighting (Lighting::Mode in_mode) |
Sets the lighting mode for the annotation. More... | |
AnnotationKit & | SetRendering (Rendering::Mode in_mode) |
Sets the rendering mode for the annotation. More... | |
AnnotationKit & | SetPosterImage (ImageKit const &in_image) |
Sets the poster image for the annotation. More... | |
AnnotationKit & | SetCarouselButtons (size_t in_count, UTF8 const in_button_names[], char const *in_previous_button_name, char const *in_next_button_name, size_t in_scroll_size) |
Sets the carousel buttons for the annotation. More... | |
AnnotationKit & | SetCarouselButtons (UTF8Array const &in_button_names, char const *in_previous_button_name, char const *in_next_button_name, size_t in_scroll_size) |
Sets the carousel buttons for the annotation. More... | |
AnnotationKit & | SetCarouselViews (size_t in_count, size_t const in_indices[], ImageKit const in_images[]=nullptr) |
Sets the carousel views for the annotation. More... | |
AnnotationKit & | SetCarouselViews (SizeTArray const &in_indices, ImageKitArray const &in_images=ImageKitArray()) |
Sets the carousel views for the annotation. More... | |
AnnotationKit & | SetPartsList (size_t in_rows, IntRectangle const &in_location, UTF8Array const &in_headers=UTF8Array(), FloatArray const &in_columns=FloatArray(), TextFieldKit const &in_text_style=TextFieldKit(), TextFieldKit const &in_header_text_style=TextFieldKit()) |
Creates a Parts List contained in a scrollable table. More... | |
AnnotationKit & | SetPartsList (size_t in_rows, IntRectangle const &in_location, char const *in_headers[3], float const in_columns[3], TextFieldKit const &in_text_style=TextFieldKit(), TextFieldKit const &in_header_text_style=TextFieldKit()) |
Creates a Parts List contained in a scrollable table. More... | |
AnnotationKit & | SetViewListByField (char const *in_field) |
Creates a View List Box which contains a list of the Views contained in the source file. More... | |
AnnotationKit & | SetViewList (IntRectangle const &in_location, HPS::Publish::ListBoxKit const &in_list) |
Creates a View List Box which contains a list of the Views contained in the source file. More... | |
AnnotationKit & | SetPMIListByField (char const *in_field) |
Creates a PMI List Box which contains a list of the PMI contained in the source file. More... | |
AnnotationKit & | SetPMIList (IntRectangle const &in_location, HPS::Publish::ListBoxKit const &in_list) |
Creates a PMI List Box which contains a list of the PMI contained in the source file. More... | |
AnnotationKit & | UnsetSource () |
Removes the source setting. More... | |
AnnotationKit & | UnsetFormat () |
Removes the format setting. More... | |
AnnotationKit & | UnsetPRCTessellationCompression () |
Removes the tessellation compression for PRC data setting. More... | |
AnnotationKit & | UnsetPRCBRepCompression () |
Removes the BRep compression level for PRC data setting. More... | |
AnnotationKit & | UnsetPRCBRepRemoval () |
Removes the BRep removal for PRC data setting. More... | |
AnnotationKit & | UnsetPRCAttributeRemoval () |
Removes the attribute removal for PRC data setting. More... | |
AnnotationKit & | UnsetU3DVersion () |
Removes the version for U3D data setting. More... | |
AnnotationKit & | UnsetU3DCompression () |
Removes the compression level for U3D data setting. More... | |
AnnotationKit & | UnsetName () |
Removes the name setting. More... | |
AnnotationKit & | UnsetArtwork () |
Removes the artwork setting. More... | |
AnnotationKit & | UnsetActivation () |
Removes the activation setting. More... | |
AnnotationKit & | UnsetDeactivation () |
Removes the deactivation setting. More... | |
AnnotationKit & | UnsetToolbarVisibility () |
Removes the toolbar visibility setting. More... | |
AnnotationKit & | UnsetModelTreeVisibility () |
Removes the model tree visibility setting. More... | |
AnnotationKit & | UnsetInteractivity () |
Removes the interactivity setting. More... | |
AnnotationKit & | UnsetBorderWidth () |
Removes the border width setting. More... | |
AnnotationKit & | UnsetTransparentBackground () |
Removes the transparent background setting. More... | |
AnnotationKit & | UnsetBackgroundColor () |
Removes the background color setting. More... | |
AnnotationKit & | UnsetLighting () |
Removes the lighting mode setting.a. More... | |
AnnotationKit & | UnsetRendering () |
Removes the rendering mode setting. More... | |
AnnotationKit & | UnsetPosterImage () |
Removes the poster image setting. More... | |
AnnotationKit & | UnsetCarouselButtons () |
Removes the carousel buttons setting. More... | |
AnnotationKit & | UnsetCarouselViews () |
Removes the carousel views setting. More... | |
AnnotationKit & | UnsetPartsList () |
Removes the Parts List setting. More... | |
AnnotationKit & | UnsetViewList () |
Removes the View List setting. More... | |
AnnotationKit & | UnsetPMIList () |
Removes the PMI List setting. More... | |
AnnotationKit & | UnsetEverything () |
Removes all data on the annotation. More... | |
bool | ShowSource (Annotation::SourceType &out_source_type, CADModel &out_cad_model, KeyPathArray &out_key_paths) const |
Shows the source setting. More... | |
bool | ShowFormat (Annotation::Format &out_format) const |
Shows the format setting. More... | |
bool | ShowPRCTessellationCompression (bool &out_state) const |
Shows the tessellation compression for PRC data setting. More... | |
bool | ShowPRCBRepCompression (PRC::BRepCompression &out_level) const |
Shows the BRep compression level for PRC data setting. More... | |
bool | ShowPRCBRepRemoval (bool &out_state) const |
Shows the BRep removal for PRC data setting. More... | |
bool | ShowPRCAttributeRemoval (bool &out_state) const |
Shows the attribute removal for PRC data setting. More... | |
bool | ShowU3DVersion (U3D::Version &out_version) const |
Shows the version for U3D data setting. More... | |
bool | ShowU3DCompression (unsigned char &out_level) const |
Shows the compression level for U3D data for the annotation. More... | |
bool | ShowName (UTF8 &out_name) const |
Shows the name setting. More... | |
bool | ShowArtwork (ArtworkKit &out_artwork) const |
Shows the artwork setting. More... | |
bool | ShowActivation (Activation::When &out_when) const |
Shows the activation setting. More... | |
bool | ShowDeactivation (Deactivation::When &out_when) const |
Shows the deactivation setting. More... | |
bool | ShowToolbarVisibility (bool &out_state) const |
Shows the toolbar visibility setting. More... | |
bool | ShowModelTreeVisibility (bool &out_state) const |
Shows the model tree visibility setting. More... | |
bool | ShowInteractivity (bool &out_state) const |
Shows the interactivity setting. More... | |
bool | ShowBorderWidth (int &out_width) const |
Shows the border width setting. More... | |
bool | ShowTransparentBackground (bool &out_state) const |
Shows the transparent background setting. More... | |
bool | ShowBackgroundColor (RGBColor &out_color) const |
Shows the background color setting. More... | |
bool | ShowLighting (Lighting::Mode &out_mode) const |
Shows the lighting mode setting. More... | |
bool | ShowRendering (Rendering::Mode &out_mode) const |
Shows the rendering mode setting. More... | |
bool | ShowPosterImage (ImageKit &out_image) const |
Shows the poster image setting. More... | |
bool | ShowCarouselButtons (UTF8Array &out_button_names, UTF8 &out_previous_button_name, UTF8 &out_next_button_name, size_t &out_scroll_size) const |
Shows the carousel buttons setting. More... | |
bool | ShowCarouselViews (SizeTArray &out_indices, ImageKitArray &out_images) const |
Shows the carousel views setting. More... | |
bool | ShowPartsList (size_t &out_rows, IntRectangle &out_location, UTF8Array &out_headers, FloatArray &out_columns, TextFieldKit &out_text_style, TextFieldKit &out_header_text_style) const |
Shows the Parts List setting. More... | |
bool | ShowViewListField (UTF8 &out_field) const |
Shows the View List setting. More... | |
bool | ShowViewList (IntRectangle &out_location, Publish::ListBoxKit &out_list) const |
Shows the View List setting. More... | |
bool | ShowPMIListField (UTF8 &out_field) const |
Shows the PMI List setting. More... | |
bool | ShowPMIList (IntRectangle &out_location, Publish::ListBoxKit &out_list) const |
Shows the PMI List setting. More... | |
virtual HPS::Type | Type () const |
This function returns the true type of the underlying object. More... | |
virtual void | Reset () |
Resets this object to its initial, uninitialized state. More... | |
bool | HasType (HPS::Type in_mask) const |
This function indicates whether this Object has the given Type mask. More... | |
intptr_t | GetClassID () const |
Returns a unique identifier that is shared by all objects of the same class. More... | |
intptr_t | GetInstanceID () const |
Returns an identifier that can be used to identify which instance of a class an object is. More... | |
Static Public Member Functions | |
static AnnotationKit | GetDefault () |
Creates a AnnotationKit which contains the default settings. More... | |
template<typename T > | |
static intptr_t | ClassID () |
Unique identifier for this class. More... | |
Static Public Attributes | |
static const HPS::Type | staticType = HPS::Type::PublishAnnotationKit |
The AnnotationKit class is a user space object.
It acts as the container for all data that can be on an annotation in a Publish PDF.
HPS::Publish::AnnotationKit::AnnotationKit | ( | ) |
The default constructor creates an empty AnnotationKit object.
HPS::Publish::AnnotationKit::AnnotationKit | ( | AnnotationKit const & | in_kit | ) |
The copy constructor creates a new AnnotationKit object that contains the same settings as the source AnnotationKit.
in_kit | The source AnnotationKit to copy. |
HPS::Publish::AnnotationKit::AnnotationKit | ( | AnnotationKit && | in_kit | ) |
The move constructor creates an AnnotationKit by transferring the underlying object of the rvalue reference to this AnnotationKit.
in_kit | An rvalue reference to an AnnotationKit to take the underlying object from. |
|
virtual |
|
inlinestaticinherited |
Unique identifier for this class.
Note: this method uses construction of static objects. If used in a constructor, it should be used in the body not the initializer list.
|
virtual |
Indicates whether this AnnotationKit has any values set on it.
Reimplemented from HPS::Object.
bool HPS::Publish::AnnotationKit::Equals | ( | AnnotationKit const & | in_kit | ) | const |
Check if the source AnnotationKit is equivalent to this AnnotationKit.
in_kit | The source AnnotationKit to compare to this AnnotationKit. |
|
inherited |
Returns a unique identifier that is shared by all objects of the same class.
|
static |
Creates a AnnotationKit which contains the default settings.
The returned object will not necessarily have values for every setting, but it will have them where it is reasonable to have a default. These values will be used for export unless a setting is overridden by the AnnotationKit passed to File::Export.
|
inherited |
Returns an identifier that can be used to identify which instance of a class an object is.
Different keys and controls will return the same value if they are backed by the same database resource.
|
inherited |
|
inlinevirtual |
bool HPS::Publish::AnnotationKit::operator!= | ( | AnnotationKit const & | in_kit | ) | const |
Check if the source AnnotationKit is not equivalent to this AnnotationKit.
in_kit | The source AnnotationKit to compare to this AnnotationKit. |
AnnotationKit& HPS::Publish::AnnotationKit::operator= | ( | AnnotationKit const & | in_kit | ) |
Copies the source AnnotationKit into this AnnotationKit.
in_kit | The source AnnotationKit to copy. |
AnnotationKit& HPS::Publish::AnnotationKit::operator= | ( | AnnotationKit && | in_kit | ) |
The move assignment operator transfers the underlying object of the rvalue reference to this AnnotationKit.
in_kit | An rvalue reference to an AnnotationKit to take the underlying object from. |
bool HPS::Publish::AnnotationKit::operator== | ( | AnnotationKit const & | in_kit | ) | const |
Check if the source AnnotationKit is equivalent to this AnnotationKit.
in_kit | The source AnnotationKit to compare to this AnnotationKit. |
|
virtualinherited |
Resets this object to its initial, uninitialized state.
Reimplemented in HPS::EventHandler, HPS::EventDispatcher, HPS::World, HPS::HighlightSearchResults, HPS::HighlightSearchResultsIterator, HPS::SelectionResults, HPS::SelectionResultsIterator, HPS::FontSearchResults, HPS::FontSearchResultsIterator, HPS::SearchResults, and HPS::SearchResultsIterator.
void HPS::Publish::AnnotationKit::Set | ( | AnnotationKit const & | in_kit | ) |
Copies the source AnnotationKit into this AnnotationKit.
in_kit | The source AnnotationKit to copy. |
AnnotationKit& HPS::Publish::AnnotationKit::SetActivation | ( | Activation::When | in_when | ) |
Sets when the annotation is activated.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_eActivateWhen.
in_when | When the annotation is activated. |
AnnotationKit& HPS::Publish::AnnotationKit::SetArtwork | ( | ArtworkKit const & | in_artwork | ) |
Sets the artwork for the annotation.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_p3DArtwork.
in_artwork | The artwork for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetBackgroundColor | ( | RGBColor const & | in_color | ) |
Sets the background color for the annotation.
Unused if there is a transparent background. This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_sBackgroundColor.
in_color | The background color for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetBorderWidth | ( | int | in_width | ) |
Sets the border width in points for the annotation.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_iAppearanceBorderWidth.
in_width | The border width in points for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetCarouselButtons | ( | size_t | in_count, |
UTF8 const | in_button_names[], | ||
char const * | in_previous_button_name, | ||
char const * | in_next_button_name, | ||
size_t | in_scroll_size | ||
) |
Sets the carousel buttons for the annotation.
This must be specified for a view carousel to be generated. This corresponds to the button names that will be passed to A3DPDFDefineViewCarousel.
in_count | Size of the following array. |
in_button_names | UTF8-encoded names for the view buttons in the carousel. |
in_previous_button_name | UTF8-encoded name for the previous button. |
in_next_button_name | UTF8-encoded name for the next button. |
in_scroll_size | Number of buttons to scroll when the previous or next buttons are pressed. |
AnnotationKit& HPS::Publish::AnnotationKit::SetCarouselButtons | ( | UTF8Array const & | in_button_names, |
char const * | in_previous_button_name, | ||
char const * | in_next_button_name, | ||
size_t | in_scroll_size | ||
) |
Sets the carousel buttons for the annotation.
This must be specified for a view carousel to be generated. This corresponds to the button names that will be passed to A3DPDFDefineViewCarousel.
in_button_names | Names for the view buttons in the carousel. |
in_previous_button_name | UTF8-encoded name for the previous button. |
in_next_button_name | UTF8-encoded name for the next button. |
in_scroll_size | Number of buttons to scroll when the previous or next buttons are pressed. |
AnnotationKit& HPS::Publish::AnnotationKit::SetCarouselViews | ( | size_t | in_count, |
size_t const | in_indices[], | ||
ImageKit const | in_images[] = nullptr |
||
) |
Sets the carousel views for the annotation.
This can be optionally specified for a view carousel. This corresponds to the views and images that will be passed to A3DPDFDefineViewCarousel.
in_count | Size of the following array. |
in_indices | Indices of the views on the associated ArtworkKit to use for the view carousel. |
in_images | Images to use for the view carousel buttons. If unspecified, images will be generated from the views themselves. |
AnnotationKit& HPS::Publish::AnnotationKit::SetCarouselViews | ( | SizeTArray const & | in_indices, |
ImageKitArray const & | in_images = ImageKitArray() |
||
) |
Sets the carousel views for the annotation.
This can be optionally specified for a view carousel. This corresponds to the views and images that will be passed to A3DPDFDefineViewCarousel.
in_indices | Indices of the views on the associated ArtworkKit to use for the view carousel. |
in_images | Images to use for the view carousel buttons. If unspecified, images will be generated from the views themselves. |
AnnotationKit& HPS::Publish::AnnotationKit::SetDeactivation | ( | Deactivation::When | in_when | ) |
Sets when the annotation is deactivated.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_eDesactiveWhen.
in_when | When the annotation is deactivated. |
AnnotationKit& HPS::Publish::AnnotationKit::SetFormat | ( | Annotation::Format | in_format | ) |
Sets the format of the 3D data for the annotation.
in_format | The format of the 3D data for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetInteractivity | ( | bool | in_state | ) |
Sets whether to enable interactivity on the annotation.
This corresponds to the (negated) value that will be passed to A3DPDF3DAnnotData::m_bDisableInteractivity.
in_state | Whether to enable interactivity on the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetLighting | ( | Lighting::Mode | in_mode | ) |
Sets the lighting mode for the annotation.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_eLighting.
in_mode | The lighting mode for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetModelTreeVisibility | ( | bool | in_state | ) |
Sets whether to display the model tree when the annotation is activated.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_bOpenModelTree.
in_state | Whether to display the model tree when the annotation is activated. |
AnnotationKit& HPS::Publish::AnnotationKit::SetName | ( | char const * | in_name | ) |
Sets the name for the annotation.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_pcName.
in_name | UTF8-encoded name for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPartsList | ( | size_t | in_rows, |
IntRectangle const & | in_location, | ||
UTF8Array const & | in_headers = UTF8Array() , |
||
FloatArray const & | in_columns = FloatArray() , |
||
TextFieldKit const & | in_text_style = TextFieldKit() , |
||
TextFieldKit const & | in_header_text_style = TextFieldKit() |
||
) |
Creates a Parts List contained in a scrollable table.
The table will have three columns, listing part number, part name and quantity. The Parts List can only be calculated if the Annotation source is a CADModel, and the annotation format is PRC.
in_rows | The number of rows for the table housing the Parts List (including the header row) |
in_location | The location of the table housing the Parts List, specified in points relative to bottom left of the page. All fields in the location will be used. |
in_headers | The strings displayed in the column headers. The size of this array should be 3. The first column lists the part numbers. The second column lists the part name. The third column lists the part quantity. Leaving it unspecified will result in a table with no headers. |
in_columns | An array of three percentages, specifying the width of each of the table's columns as a percentage of the table width. The total of the values contained in in_columns should total 1.0. For example, if the columns should take up 10%, 80% and 10% of the table width respectively, in_column will contain 0.1, 0.8, 0.1 Leaving in_columns unspecified will use the default column widths. |
in_text_style | The text style used for the cells of the table. If not specified, default formatting is used. |
in_header_text_style | The text style used for the header of the table. If not specified, default formatting is used. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPartsList | ( | size_t | in_rows, |
IntRectangle const & | in_location, | ||
char const * | in_headers[3], | ||
float const | in_columns[3], | ||
TextFieldKit const & | in_text_style = TextFieldKit() , |
||
TextFieldKit const & | in_header_text_style = TextFieldKit() |
||
) |
Creates a Parts List contained in a scrollable table.
The table will have three columns, listing part number, part name and quantity. The Parts List can only be calculated if the Annotation source is a CADModel, and the annotation format is PRC.
in_rows | The number of rows for the table housing the Parts List (including the header row) |
in_location | The location of the table housing the Parts List, specified in points relative to bottom left of the page. All fields in the location will be used. |
in_headers | The strings displayed in the column headers. The first column lists the part numbers. The second column lists the part name. The third column lists the part quantity. Leaving it unspecified will result in a table with no headers. |
in_columns | An array of three percentages, specifying the width of each of the table's columns as a percentage of the table width. The total of the values contained in in_columns should total 1.0. For example, if the columns should take up 10%, 80% and 10% of the table width respectively, in_column will contain 0.1, 0.8, 0.1 Leaving in_columns unspecified will use the default column widths. |
in_text_style | The text style used for the cells of the table. If not specified, default formatting is used. |
in_header_text_style | The text style used for the header of the table. If not specified, default formatting is used. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPMIList | ( | IntRectangle const & | in_location, |
HPS::Publish::ListBoxKit const & | in_list | ||
) |
Creates a PMI List Box which contains a list of the PMI contained in the source file.
Clicking on the entries of the list will highlight the associated PMI in the 3D annotation. The PMI List can only be calculated if the Annotation source is a CADModel, and the annotation format is PRC. If a View List or a View Carousel are also set on this annotation kit, the PMI List will only show the PMIs which are visible in the View you currently have selected in the PDF.
in_location | The location of the PMI List, specified in points relative to bottom left of the page. All fields in the location will be used. |
in_list | The ListBoxKit used to specify the attributes of the PMI List. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPMIListByField | ( | char const * | in_field | ) |
Creates a PMI List Box which contains a list of the PMI contained in the source file.
Clicking on the entries of the list will highlight the associated PMI in the 3D annotation. The PMI List can only be calculated if the Annotation source is a CADModel, and the annotation format is PRC. If a View List or a View Carousel are also set on this annotation kit, the PMI List will only show the PMIs which are visible in the View you currently have selected in the PDF.
in_field | UTF8-encoded form field name for the PMI List. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPosterImage | ( | ImageKit const & | in_image | ) |
Sets the poster image for the annotation.
If this is not specified a poster image will be generated by Publish. This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_pPosterImage.
in_image | The poster image for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPRCAttributeRemoval | ( | bool | in_state | ) |
Sets whether to remove the attribute information in the PRC data for this annotation.
This setting is only relevant if the format of the annotation is Annotation::Format::PRC. This corresponds to the value that will be passed to A3DRWParamsExportPrcData::m_bRemoveAttributes.
in_state | Whether to remove the attribute information in the PRC data for this annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPRCBRepCompression | ( | PRC::BRepCompression | in_level | ) |
Sets the level of compression to apply to BRep data for a PRC annotation.
This setting is only relevant if the format of the annotation is Annotation::Format::PRC. This corresponds to the values that will be passed to A3DRWParamsExportPrcData::m_bCompressBrep and A3DRWParamsExportPrcData::m_eCompressBrepType.
in_level | The level of compression to apply to BRep data for a PRC annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPRCBRepRemoval | ( | bool | in_state | ) |
Sets whether to remove the BRep information in the PRC data for this annotation.
This setting is only relevant if the format of the annotation is Annotation::Format::PRC. This corresponds to the value that will be passed to A3DRWParamsExportPrcData::m_bRemoveBRep.
in_state | Whether to remove BRep information in the PRC data for this annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetPRCTessellationCompression | ( | bool | in_state | ) |
Sets whether to compress tessellation for a PRC annotation.
This setting is only relevant if the format of the annotation is Annotation::Format::PRC. This corresponds to the value that will be passed to A3DRWParamsExportPrcData::m_bCompressTessellation.
in_state | Whether to compress tessellation for a PRC annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetRendering | ( | Rendering::Mode | in_mode | ) |
Sets the rendering mode for the annotation.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_eRenderingStyle.
in_mode | The rendering mode for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetSource | ( | CADModel const & | in_cad_model | ) |
Sets the source for the annotation to Annotation::SourceType::CADModel.
This is the CADModel which contains the 3D data to be exported into the annotation
in_cad_model | The source CADModel for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetSource | ( | KeyPathArray const & | in_sources | ) |
Sets the source for the annotation to Annotation::SourceType::KeyPaths.
These are the KeyPaths that will be used to locate the 3D data for the annotation.
in_sources | The source KeyPaths for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetSource | ( | size_t | in_count, |
KeyPath const | in_sources[] | ||
) |
Sets the source for the annotation to Annotation::SourceType::KeyPaths.
These are the KeyPaths that will be used to locate the 3D data for the annotation.
in_count | The number of elements in in_sources |
in_sources | The source KeyPaths for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetSource | ( | KeyPath const & | in_source | ) |
Sets the source for the annotation to Annotation::SourceType::KeyPaths.
The Key Path that will be used to locate the 3D data for the annotation.
in_source | The source KeyPath for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetSource | ( | CADModel const & | in_cad_model, |
KeyPathArray const & | in_additional_sources | ||
) |
Sets the source for the annotation to Annotation::SourceType::CADModelAndKeyPaths.
These are the CADModel which will be used to export 3D data to the annotation, and the KeyPaths which will be added to the model
in_cad_model | The source CADModel for the annotation. |
in_additional_sources | The additional source KeyPaths for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetSource | ( | CADModel const & | in_cad_model, |
size_t | in_count, | ||
KeyPath const | in_additional_sources[] | ||
) |
Sets the source for the annotation to Annotation::SourceType::CADModelAndKeyPaths.
These are the CADModel which will be used to export 3D data to the annotation, and the KeyPaths which will be added to the model
in_cad_model | The source CADModel for the annotation. |
in_count | The number of elements in in_additional_sources |
in_additional_sources | The additional source KeyPaths for the annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetToolbarVisibility | ( | bool | in_state | ) |
Sets whether to display the toolbar when the annotation is activated.
This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_bShowToolbar.
in_state | Whether to display the toolbar when the annotation is activated. |
AnnotationKit& HPS::Publish::AnnotationKit::SetTransparentBackground | ( | bool | in_state | ) |
Sets whether the annotation background is transparent.
This will render background color irrelevant and has negative ramifications. This corresponds to the value that will be passed to A3DPDF3DAnnotData::m_bTransparentBackground.
in_state | Whether the annotation background is transparent. |
AnnotationKit& HPS::Publish::AnnotationKit::SetU3DCompression | ( | unsigned char | in_level | ) |
Sets the level of compression to apply to tessellations for a U3D annotation.
If no compression level is set, no compression will be applied. This setting is only relevant if the format of the annotation is Annotation::Format::U3D. This corresponds to the value that will be passed to A3DRWParamsExportU3DData::m_ucMeshQualityValue.
in_level | The level of compression to apply to tessellations for a U3D annotation. This value should be in the range [0, 100]. |
AnnotationKit& HPS::Publish::AnnotationKit::SetU3DVersion | ( | U3D::Version | in_version | ) |
Sets the version of the data for a U3D annotation.
This setting is only relevant if the format of the annotation is Annotation::Format::U3D. This corresponds to the value that will be passed to A3DRWParamsExportU3DData::m_eU3DVersion.
in_version | The version of the data for a U3D annotation. |
AnnotationKit& HPS::Publish::AnnotationKit::SetViewList | ( | IntRectangle const & | in_location, |
HPS::Publish::ListBoxKit const & | in_list | ||
) |
Creates a View List Box which contains a list of the Views contained in the source file.
Clicking on the entries of the list will activate the associated View. The View List can only be calculated if the Annotation source is a CADModel, and the annotation format is PRC.
in_location | The location of the View List, specified in points relative to bottom left of the page. All fields in the location will be used. |
in_list | The ListBoxKit used to specify the attributes of the View List. |
AnnotationKit& HPS::Publish::AnnotationKit::SetViewListByField | ( | char const * | in_field | ) |
Creates a View List Box which contains a list of the Views contained in the source file.
Clicking on the entries of the list will activate the associated View. The View List can only be calculated if the Annotation source is a CADModel, and the annotation format is PRC.
in_field | UTF8-encoded form field name for the View List. |
void HPS::Publish::AnnotationKit::Show | ( | AnnotationKit & | out_kit | ) | const |
Copies this AnnotationKit into the given AnnotationKit.
out_kit | The AnnotationKit to populate with the contents of this AnnotationKit. |
bool HPS::Publish::AnnotationKit::ShowActivation | ( | Activation::When & | out_when | ) | const |
Shows the activation setting.
out_when | When the annotation is activated. |
bool HPS::Publish::AnnotationKit::ShowArtwork | ( | ArtworkKit & | out_artwork | ) | const |
Shows the artwork setting.
out_artwork | The artwork for the annotation. |
bool HPS::Publish::AnnotationKit::ShowBackgroundColor | ( | RGBColor & | out_color | ) | const |
Shows the background color setting.
out_color | The background color for the annotation. |
bool HPS::Publish::AnnotationKit::ShowBorderWidth | ( | int & | out_width | ) | const |
Shows the border width setting.
out_width | The border width of the annotation. |
bool HPS::Publish::AnnotationKit::ShowCarouselButtons | ( | UTF8Array & | out_button_names, |
UTF8 & | out_previous_button_name, | ||
UTF8 & | out_next_button_name, | ||
size_t & | out_scroll_size | ||
) | const |
Shows the carousel buttons setting.
out_button_names | Names for the view buttons in the carousel. |
out_previous_button_name | Name for the previous button. |
out_next_button_name | Name for the next button. |
out_scroll_size | Numbers of buttons scrolled when the previous or next buttons are pressed. |
bool HPS::Publish::AnnotationKit::ShowCarouselViews | ( | SizeTArray & | out_indices, |
ImageKitArray & | out_images | ||
) | const |
Shows the carousel views setting.
out_indices | Indices of the views on the associated ArtworkKit to use for the view carousel. |
out_images | Images to use for the view carousel buttons. May be empty, even if out_indices is not. |
bool HPS::Publish::AnnotationKit::ShowDeactivation | ( | Deactivation::When & | out_when | ) | const |
Shows the deactivation setting.
out_when | When the annotation is deactivated. |
bool HPS::Publish::AnnotationKit::ShowFormat | ( | Annotation::Format & | out_format | ) | const |
Shows the format setting.
out_format | The format of the 3D data for the annotation. |
bool HPS::Publish::AnnotationKit::ShowInteractivity | ( | bool & | out_state | ) | const |
Shows the interactivity setting.
out_state | Whether to enable interactivity on the annotation. |
bool HPS::Publish::AnnotationKit::ShowLighting | ( | Lighting::Mode & | out_mode | ) | const |
Shows the lighting mode setting.
out_mode | The lighting mode for the annotation. |
bool HPS::Publish::AnnotationKit::ShowModelTreeVisibility | ( | bool & | out_state | ) | const |
Shows the model tree visibility setting.
out_state | Whether to display the model tree when the annotation is activated. |
bool HPS::Publish::AnnotationKit::ShowName | ( | UTF8 & | out_name | ) | const |
Shows the name setting.
out_name | The name for the annotation. |
bool HPS::Publish::AnnotationKit::ShowPartsList | ( | size_t & | out_rows, |
IntRectangle & | out_location, | ||
UTF8Array & | out_headers, | ||
FloatArray & | out_columns, | ||
TextFieldKit & | out_text_style, | ||
TextFieldKit & | out_header_text_style | ||
) | const |
Shows the Parts List setting.
out_rows | The number of rows making up the Parts List table. |
out_location | The location of the Parts List table. |
out_headers | The strings of the column headers. Empty if the table has no header. |
out_columns | The width of the three columns as percentages of the table width. |
out_text_style | The text styles used for the cells in the table. |
out_header_text_style | The text styles used for the header of the table. |
bool HPS::Publish::AnnotationKit::ShowPMIList | ( | IntRectangle & | out_location, |
Publish::ListBoxKit & | out_list | ||
) | const |
Shows the PMI List setting.
out_location | The location of the PMI List table. |
out_list | The options specified for the list box containing the PMI List |
bool HPS::Publish::AnnotationKit::ShowPMIListField | ( | UTF8 & | out_field | ) | const |
Shows the PMI List setting.
out_field | The list box form field name on the page which will be used for the PMI List. |
bool HPS::Publish::AnnotationKit::ShowPosterImage | ( | ImageKit & | out_image | ) | const |
Shows the poster image setting.
out_image | The poster image for the annotation. |
bool HPS::Publish::AnnotationKit::ShowPRCAttributeRemoval | ( | bool & | out_state | ) | const |
bool HPS::Publish::AnnotationKit::ShowPRCBRepCompression | ( | PRC::BRepCompression & | out_level | ) | const |
bool HPS::Publish::AnnotationKit::ShowPRCBRepRemoval | ( | bool & | out_state | ) | const |
bool HPS::Publish::AnnotationKit::ShowPRCTessellationCompression | ( | bool & | out_state | ) | const |
bool HPS::Publish::AnnotationKit::ShowRendering | ( | Rendering::Mode & | out_mode | ) | const |
Shows the rendering mode setting.
out_mode | The rendering mode for the annotation. |
bool HPS::Publish::AnnotationKit::ShowSource | ( | Annotation::SourceType & | out_source_type, |
CADModel & | out_cad_model, | ||
KeyPathArray & | out_key_paths | ||
) | const |
Shows the source setting.
out_source_type | Specifies which one of the previous arguments is valid |
out_cad_model | The source CADModel for the annotation. Only valid if out_source_type is CADModel or CADModelAndKeyPath |
out_key_paths | The source KeyPath array for the annotation. Only valid if out_source_type is KeyPath or CADModelAndKeyPath |
bool HPS::Publish::AnnotationKit::ShowToolbarVisibility | ( | bool & | out_state | ) | const |
Shows the toolbar visibility setting.
out_state | Whether to display the toolbar when the annotation is activated. |
bool HPS::Publish::AnnotationKit::ShowTransparentBackground | ( | bool & | out_state | ) | const |
Shows the transparent background setting.
out_state | Whether the annotation has a transparent background. |
bool HPS::Publish::AnnotationKit::ShowU3DCompression | ( | unsigned char & | out_level | ) | const |
bool HPS::Publish::AnnotationKit::ShowU3DVersion | ( | U3D::Version & | out_version | ) | const |
bool HPS::Publish::AnnotationKit::ShowViewList | ( | IntRectangle & | out_location, |
Publish::ListBoxKit & | out_list | ||
) | const |
bool HPS::Publish::AnnotationKit::ShowViewListField | ( | UTF8 & | out_field | ) | const |
|
virtualinherited |
This function returns the true type of the underlying object.
This function is useful for finding the type of smart pointer objects that have been cast to more generic types.
Reimplemented in HPS::UpdateOptionsControl, HPS::HighlightControl, HPS::SelectionOptionsControl, HPS::OffScreenWindowOptionsControl, HPS::ApplicationWindowOptionsControl, HPS::StandAloneWindowOptionsControl, HPS::AttributeLockControl, HPS::WindowInfoControl, HPS::DebuggingControl, HPS::SubwindowControl, HPS::ContourLineControl, HPS::VisualEffectsControl, HPS::TransformMaskControl, HPS::PostProcessEffectsControl, HPS::DrawingAttributeControl, HPS::HiddenLineAttributeControl, HPS::PerformanceControl, HPS::NURBSSurfaceAttributeControl, HPS::ConditionControl, HPS::StyleControl, HPS::PortfolioControl, HPS::MaterialMappingControl, HPS::TextureMatrixControl, HPS::ModellingMatrixControl, HPS::CurveAttributeControl, HPS::EdgeAttributeControl, HPS::LineAttributeControl, HPS::TextAttributeControl, HPS::CuttingSectionAttributeControl, HPS::CylinderAttributeControl, HPS::LightingAttributeControl, HPS::SphereAttributeControl, HPS::MarkerAttributeControl, HPS::CullingControl, HPS::ColorInterpolationControl, HPS::TransparencyControl, HPS::SelectabilityControl, HPS::CameraControl, HPS::VisibilityControl, HPS::BoundingControl, HPS::Kit, and HPS::Control.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetActivation | ( | ) |
Removes the activation setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetArtwork | ( | ) |
Removes the artwork setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetBackgroundColor | ( | ) |
Removes the background color setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetBorderWidth | ( | ) |
Removes the border width setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetCarouselButtons | ( | ) |
Removes the carousel buttons setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetCarouselViews | ( | ) |
Removes the carousel views setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetDeactivation | ( | ) |
Removes the deactivation setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetEverything | ( | ) |
Removes all data on the annotation.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetFormat | ( | ) |
Removes the format setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetInteractivity | ( | ) |
Removes the interactivity setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetLighting | ( | ) |
Removes the lighting mode setting.a.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetModelTreeVisibility | ( | ) |
Removes the model tree visibility setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetName | ( | ) |
Removes the name setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetPartsList | ( | ) |
Removes the Parts List setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetPMIList | ( | ) |
Removes the PMI List setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetPosterImage | ( | ) |
Removes the poster image setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetPRCAttributeRemoval | ( | ) |
Removes the attribute removal for PRC data setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetPRCBRepCompression | ( | ) |
Removes the BRep compression level for PRC data setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetPRCBRepRemoval | ( | ) |
Removes the BRep removal for PRC data setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetPRCTessellationCompression | ( | ) |
Removes the tessellation compression for PRC data setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetRendering | ( | ) |
Removes the rendering mode setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetSource | ( | ) |
Removes the source setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetToolbarVisibility | ( | ) |
Removes the toolbar visibility setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetTransparentBackground | ( | ) |
Removes the transparent background setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetU3DCompression | ( | ) |
Removes the compression level for U3D data setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetU3DVersion | ( | ) |
Removes the version for U3D data setting.
AnnotationKit& HPS::Publish::AnnotationKit::UnsetViewList | ( | ) |
Removes the View List setting.
|
static |