####### Widgets ####### Widget > Add Carousel ====================== The carousel of views is a widget that can be inserted in the PDF document to list the 3D views. The views are presented as image thumbnails, allowing the user to easily browse and activate one. To activate a view, click on its thumbnail. The 3D annotation will then transition to that view. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page21_img1.png :align: center A carousel of views Creation of a Carousel ---------------------- 1. Within the Tetra4D Enrich toolbar, choose Widget > Add Carousel. 2. | Drag a rectangle to define the location and the size of the carousel. | The rectangle cannot overlap with other Tetra4D Enrich items. | Once the rectangle is defined, the Carousel editor panel appears on the right. 3. Use the frame controllers to resize the carousel, if needed. 4. Adjust the carousel properties to your specifications by selecting the commands in the Edit panel in the right. 5. Click on the green check button “Validate the carousel modifications” icon to save the carousel, or 6. Click on the red “X” button “Cancel the carousel modifications” icon to discard the changes. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page21_img2.png :align: center Creation of a Carousel of views .. note:: The carousel can be defined either as a horizontal or vertical frame. By default, the carousel shows three views and two buttons that allow the user to scroll the views. The buttons will be automatically repositioned depending on the orientation of the carousel. Definition of the Carousel layout --------------------------------- The Editor panel offers several settings to define the layout of the Carousel. Hover your mouse over any of the buttons to see the specific command. * **Global settings:** Defines the number of rows and columns, the colors, and the font information. * **Advanced settings:** Defines the icons used for side buttons and regenerates the thumbnails of the views. * **Views:** Defines the views that are listed in the Carousel, and their order. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page22_img1.png :align: center Edit panel for Carousel of Views Global settings subpanel ------------------------ * **Font settings:** Defines the font and the font size for the names of views displayed in the thumbnails. * **Font color, Bold, Italic:** Applies to the names of views displayed in the thumbnails. * **Background color:** Defines the background color of the carousel. .. note:: The background color applies to the carousel only and doesn’t affect the thumbnails themselves. * **Column number:** Defines the number of columns of the carousel. The value is limited to a range of 1 to 10 * **Row number:** Defines the number of rows of the carousel. The value is limited to a range of 1 to 10. .. note:: Of particular importance are the "Column number" and "Row number" options. Make sure the number of rows and columns makes sense for the space that the carousel is occupying. For example, you normally wouldn't want a horizontally oriented carousel to have a single column with multiple rows. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page23_img2.png :align: center Global settings area of the Carousel edit panel Advanced settings subpanel -------------------------- .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page24_img1.png :align: center Advanced settings area of the Carousel edit panel .. |display_hide| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page24_img2.png * |display_hide| **Display/hide poster/text and change text position:** * **Display text:** Displays or hides the view titles in the carousel * **Display poster:** Displays or hides the screenshot (poster) images in the carousel * **Change text position:** Repositions the view titles. The options are above or below the poster images. .. |change_poster| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page24_img3.png * |change_poster| **Change or reload posters:** * | **Change poster:** Opens a dialog which allows to select a new poster image from the file system. | This option applies to the thumbnail currently selected in the Carousel. * | **Update poster:** Regenerates the view poster image. This action may be required if the | view has been modified by the user and the poster needs to be updated to reflect the | modification. | This option applies to the thumbnail currently selected in the Carousel. * **Update all posters:** Regenerates all view poster images. This action may be required if some views have been modified by the user and the posters need to be updated to reflect the modifications. .. |change_button| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page24_img4.png * |change_button| **Change the previous / next button icon:** * The left and right arrows icons that appear in the carousel of views can be changed by selecting a new image from the file system. Views subpanel -------------- If you wish to exclude certain views from the view carousel, simply uncheck the view name in the "Views" area of the sidebar. The green check will be replaced with a red X indicating the view is to be excluded. Views can also be reordered. Click on one view in the list and drag it to another place. Reordering the views only affects the carousel presentation - it has no effect on the PDF views. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page25_img1.png :align: center Views settings area of the Carousel editor panel * **Deactivation of a view:** Click on an active view (marked by a green check) in the list. * **Activation of a view:** Click on a deactivated view (marked by a red cross) in the list. * **Reordering views:** Click the view to be reordered while maintaining the mouse button pressed, and drag the view to the new position in the list. Make sure the view is not deactivated. Widget > Add part list (flat) ============================= The “Add part list (flat)” menu allows you to create a table in the PDF document. The flat part list is generated by parsing the model structure of the 3D parts. Creation of a part list (flat) ------------------------------ This table is generated from the 3D data in the PDF document. 1. Within the Tetra4D Enrich toolbar, choose Widget > Add part list (flat). 2. Drag a rectangle to define the location and the size of the table. 3. Use the frame controllers to resize the table. 4. Drag the table border to reposition the table if required. 5. Adjust the table properties to your specifications by selecting the options in the Edit panel in the right. .. note:: Refer to Definition of the part list and table settings to have detailed explanations about how to customize the table presentation. 6. Click on the green check “Validate the table modifications” icon to save the carousel, or 7. Click on the red “X” “Cancel the table modifications” icon to discard the changes. The flat part lists are generated according to the 3D model currently present in the PDF document. The flat part list only lists the components of the assembly and the total number of these components, independent of their position in the assembly hierarchy. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page26_img1.png :align: center “flat part list” table Widget > Add part list (hierarchical) ===================================== The “Add part list (hierarchical)” menu allows you to create a table in the PDF document. The hierarchical part list is generated by parsing the model structure of the 3D parts. Creation of a part list (hierarchical) -------------------------------------- This table is generated from the 3D data in the PDF document. 1. Within the Tetra4D Enrich toolbar, choose Widget > Add part list (hierarchical). 2. Drag a rectangle to define the location and the size of the table. 3. Use the frame controllers to resize the table. 4. Drag the table border to reposition the table if required. 5. Adjust the table properties to your specifications by selecting the options in the Edit panel in the right. .. note:: Refer to Definition of the part list and table settings to have detailed explanations about how to customize the table presentation. 6. Click on the green check “Validate the table modifications” icon to save the table, or 7. Click on the red “X” “Cancel the table modifications” icon to discard the changes. The hierarchical part lists are generated according to the 3D model currently present in the PDF document. The hierarchical part list reflects the hierarchy of the 3D information. Sub-assemblies are shown with indented part names and the components quantities are calculated locally, at the hierarchical level where they are found. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page27_img1.png :align: center A “hierarchical part list” table Widget > Add table from CSV =========================== The “Add a table from CSV” menu allows you to create a table in the PDF document from external data defined in a CSV. Creation of a table from CSV ---------------------------- This table is generated from a chosen CSV file. 1. Within the Tetra4D Enrich toolbar, choose Widget > Add table from CSV. 2. Drag a rectangle to define the location and the size of the table. 3. Use the frame controllers to resize the table if required. 4. Drag the table border to reposition the table if required. 5. Adjust the table properties to your specifications by selecting the options in the Edit panel in the right. .. note:: Refer to Definition of the part list and table settings to have detailed explanations about how to customize the table presentation. 6. Click on the green check “Validate the table modifications” icon to save the carousel, or 7. Click on the red “X” “Cancel the table modifications” icon to discard the changes. Table created from a CSV file has no link with the 3D parts of the 3D annotation. To map table rows with 3D parts, refer to “3D Attributes / 3D Mapping” section. To create actions triggered by a selection of a row of the table, refer to “On table row” section. .. note:: CSV format The CSV format expected by Tetra4D Enrich is shown below: | Column 1 title;Column 2 title;Column 3 title | C1 R1 value;C2 R1 value;C3 R1 value | C1 R2 value;C2 R2 value;C3 R2 value | C1 R3 value;C2 R3 value;C3 R3 value The first line of the CSV file will be used to define the title of the columns in the table. The separator must be “;”. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page28_img1.png :align: center A “Table from CSV” table Widget > Add table from clipboard ================================= The “Add a table from clipboard” menu allows you to create a table in the PDF document from the system clipboard. Creation of a table from clipboard ---------------------------------- A table can be defined using data that is stored on the system clipboard. This is very similar to adding the table from a CSV file – the only difference is that instead of showing a dialog to select a CSV file, Tetra4 Enrich will grab the data automatically from the clipboard. 1. Make sure the clipboard contains the table information. Then, within the Tetra4D Enrich toolbar, choose Widget > Add table from clipboard. 2. Drag a rectangle to define the location and the size of the table. 3. Use the frame controllers to resize the table. 4. Drag the table border to reposition the table if required. 5. Adjust the table properties to your specifications by selecting the options in the Edit panel in the right. .. note:: Refer to Definition of the part list and table settings to have detailed explanations about how to customize the table presentation. 6. Click on the green check “Validate the table modifications” icon to save the table, or 7. Click on the red “X” “Cancel the table modifications” icon to discard the changes. Tables created from the clipboard have no link with the 3D parts of the 3D annotation. To map table rows with 3D parts, refer to “3D Attributes / 3D Mapping”. To create actions triggered by a selection of a row of the table, refer to “On table row” section. .. note:: Format of information copied in the clipboard The contents of the clipboard must correspond to a table having multiple lines and rows. The column titles must be defined by the first row. Supported applications to copy the table information in the clipboard are Microsoft Excel and Google Sheets. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page29_img1.png :align: center Information in a spreadsheet (before being copied in the clipboard) .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page29_img2.png :align: center Corresponding “Table from clipboard” Definition of the part list and table settings ---------------------------------------------- The Edit panel contains several settings to define the layout of the part list and table and to map its content with the 3D model if required. Hover your mouse over any of the buttons to see the specific command. * **Global settings:** Defines the colors and the font information. * **Emphasize:** Defines how the selected part will be emphasized in the 3D annotation. * **Column alignment:** Defines the alignment of a selected column. * **Add or remove columns:** Enables you to add or remove a column. * **3D Attributes / 3D Mapping:** Defines what information is displayed in a selected column and enables you to map the table with the 3D model if required. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page30_img1.png :align: center Edit panel for the table Global settings subpanel ------------------------ * **Font settings:** Defines the font and the font size of all the information visible in the table. * **Font color, Bold, Italic:** Defines the color and text attributes of all the information visible in the table. .. |bg_color| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page31_img1.png * |bg_color| **Background color:** Defines the background color of the table. Note: The background color applies to the full table. .. |header_bold| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page31_img2.png * |header_bold| **Make header bold:** set the header of the table to bold Note: This setting enables to display header in bold while the table is displayed as non-bold. .. |border| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page31_img3.png * |border| **Add a border:** Draws a frame around the table. Note: The frame settings (color, thickness) are fixed and can’t be modified. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page31_img4.png :align: center Global settings area of the table edit panel Emphasize subpanel ------------------ The Emphasize feature allows you to control how parts corresponding to the selected row in the table are emphasized in the 3D annotation. There are three possibilities: * Emphasize with color and opacity: Parts are emphasized by a color change while all the other parts are displayed with opacity. * Emphasize with color: Parts are emphasized by a color change while all the other parts remain displayed without any change. * Emphasize with isolate: Parts are emphasized by an “isolate” operation (they remain visible and all the other parts are hidden). A “fit-all” operation is automatically performed in order to zoom to the emphasized parts Depending on the chosen emphasize mode, some additional settings are available: .. |color| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page32_img1.png * |color| **Emphasize color:** Defines the color used to emphasize the search results. * **Opacity slider:** Defines the opacity value, when the “Emphasize with color and opacity” mode is selected. * | **Enable blinking:** Activates blinking of the search results. | Blinking is defined by two parameters: * Period: Defines the period time (in seconds) for every blink of the parts. * Number: Defines the number of blinking that occur for any highlight event. Note: The “Enable blinking” option is not available with the “Emphasize by isolate” mode. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page32_img2.png :align: center Emphasize settings area of the Table panel Column Alignment settings ------------------------- .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page33_img1.png :align: center Column alignment settings area of the Table edit panel .. |align_left| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page33_img2.png * |align_left| **Align left:** Align the selected column to left. Note: This setting applies to the selected column. The selected column is the one in which the mouse cursor is placed. .. |align_center| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page33_img3.png * |align_center| **Align Center:** Align the selected column to center. Note: This setting applies to the selected column. The selected column is the one in which the mouse cursor is placed. .. |align_right| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page33_img4.png * |align_right| **Align right:** Align the selected column to right. Note: This setting applies to the selected column. The selected column is the one in which the mouse cursor is placed. Add or remove columns settings ------------------------------ .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page33_img5.png :align: center Add or remove column settings area of the Table edit panel .. |insert_col_left| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page33_img6.png * |insert_col_left| **Insert column to the left:** Insert a new column to the left of the selected one. Note: The selected column is the one in which the mouse cursor is placed. .. |insert_col_right| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page33_img7.png * |insert_col_right| **Insert column to the right:** Insert a new column to the right of the selected one. Note: The selected column is the one in which the mouse cursor is placed. .. |delete_col| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page33_img8.png * |delete_col| **Delete column:** Delete the selected column. Note: The selected column is the one in which the mouse cursor is placed. 3D Attributes / 3D Mapping subpanel ----------------------------------- The 3D Attributes feature allows you to control which data is displayed in the columns of the table. In case of a Part list (flat or hierarchical), the following information is listed in the table by default: * row number (title of column: #, name in the list of attributes: #Computed #), * part name (title of column: NAME, name in the list of attributes: #Computed NAME), * quantity (title of column: QTY, name in the list of attributes: #Computed QTY). However, it is possible to display different information in one existing column, or in an added column. The 3D Mapping feature allows you to map the information currently displayed in the table with the 3D model. This feature is meant to be used with tables created using the features Add table from CSV or Add table from clipboard. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page34_img1.png :align: center 3D Attributes / 3D Mapping Settings area of the Table edit panel .. |fill_col_attr| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page34_img2.png * |fill_col_attr| **Fill column with attribute:** Fill the selected column with attributes linked to the 3D model. 1. Select the column you want to fill by selecting a cell in the column. There is no need to select the full column, just the top row of the column. 2. Click on the Fill column with attributes icon. 3. Select the attribute in the list of attributes from the dropdown. 4. Check the result in the table. The attributes that are listed in the list depend on the CAD model currently loaded in the PDF document, and on the additional attributes that may have been imported in the PDF document using the “ADD 3D attribute” feature. The default information that is listed in the table consists of: * Row number (title of column: #, name in the list of attributes: #Computed #), * Part name (title of column: NAME, name in the list of attributes: #Computed NAME), * Quantity (title of column: QTY, name in the list of attributes: #Computed QTY). .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page35_img1.png :align: center List of attributes provided by the Fill column with attribute feature .. |gear| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page35_img2.png - |gear| : System information (default information displayed when the table is created). .. |download| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page35_img3.png - |download| : Attributes that have been imported and linked to the 3D parts. .. |map_col| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page35_img4.png - |map_col|: (no icon) Attribute defined in the CAD data (so that have been read while adding the 3D information in the PDF document. .. |map_col_3d| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page36_img1.png * |map_col_3d| **Map selected column with 3D parts:** Use the selected column to map the rows of the table with the 3D parts. 1. | Create the table using “Add table from CSV” or “Add table from clipboard” features. | Note: See detailed explanations on “Add table from CSV” or “Add table from clipboard”. 2. Select the column you want to use as a key for the mapping by selecting a cell in the column. Note: An example is provided next page. 3. Click on the Map selected column with 3D parts icon. 4. Check the result of the mapping in the dialog that pops-up. 5. Click OK to close the dialog. The “Map selected column with 3D parts” feature is available with tables created using the “Add table from CSV” or “Add table from clipboard” features. In the case of a table created using the Part list (flat or hierarchical) feature, this function will not be active, because these tables are already linked with the 3D data. Mapping the rows of the table with 3D parts enables a cross-highlight between the table and the 3D annotation, when selecting a row in the table or when selecting a part in the 3D annotation. The “mapping” means “correlate the values from this column to the corresponding 3D part”. The column title is important, because it is the key used to perform the mapping. For example, if the column title is “ItemNumber”, the mapping will work if the 3D parts contain an attribute named “ItemNumber”. Enrich will look for all the parts, and make the mapping between the table row and a particular part that matches ItemNumber. **Remark: Example of mapping between a CSV table and the 3D parts** The table below is mapped with the 3D parts based on the column ItemNumber (in this example, ItemNumber is an attribute which is defined in all the 3D parts). Once the table has been inserted in the document, the ItemNumber column must be selected and the feature “Map selected column with 3D parts” will execute the mapping based on this key. Afterwards, the mapping is managed by looking at all the values listed in the column of parts attributes. The table row and part become linked when the value of the key attribute for a 3D part matches with the value of the attribute present in the table. Below, the main housing part is linked to the highlighted table row because the ItemNumber values are the same: H7894561. **Mapping of the table rows with the 3D parts based on an attribute:** .. list-table:: :widths: 1 1 1 :header-rows: 0 * - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page37_img1.png - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page37_img2.png - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page37_img3.png The table below is mapped with the 3D parts based on the names of the parts. The names of the parts can be accessed using the key #Computed NAME. Consequently, the title of the column that contains the names of the parts must be #Computed NAME. **Mapping of the table rows with the 3D parts based on the names of the parts:** .. list-table:: :widths: 1 1 1 :header-rows: 0 * - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page37_img4.png - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page37_img5.png - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page37_img7.png .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page37_img6.png Widget > Add Search =================== The “Search” is a widget that can be inserted in the PDF document to enable search operations on the 3D information that are present in the document. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page38_img1.png :align: center A Search widget Creation of a Search widget --------------------------- 1. Within the Tetra4D Enrich toolbar, choose Widget > Add Search. 2. | Drag a rectangle to define the location and the size of the Search widget. | The rectangle cannot overlap with other Tetra4D Enrich items. | Once the rectangle is defined, the Search editor panel appears on the right. 3. Use the frame controllers to resize the search widget if needed. 4. Adjust the Search widget properties to your specifications by selecting the commands in the Edit panel in the right. 5. | Define the search criteria in the Edit panel in the right. | Note: Refer to Search criteria subpanel to have detailed explanations about the search criteria. | Note: Refer to Search Presets sample to have detailed explanations about the creation of presets. 6. Click on the green check button “Validate the Search modifications” icon to save the Search widget, or 7. Click on the red “X” button “Cancel the Search modifications” icon to discard the changes. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page38_img2.png :align: center Creation of a Search widget Definition of the Search widget ------------------------------- The Editor panel offers several settings to define the behavior and the layout of the Search widget. Hover your mouse over any of the buttons to see the specific command. * **Global settings:** Defines the colors and the font information for the widget. * **Emphasize:** Defines how the searched parts will be emphasized in the 3D annotation. * **Advanced settings:** Defines the icon used in the widget. * **Search criteria:** Defines the search criteria and search presets that will be supported. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page39_img1.png :align: center Edit panel for Search widget Global settings subpanel ------------------------ * **Font settings:** Defines the font and the font size for used in the search widget. * **Font color, Bold, Italic:** Applies to the font used in the search widget. .. |search_bg| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page40_img1.png * |search_bg| **Background color:** Defines the background color of the Search widget. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page40_img2.png :align: center Global settings area of the search edit panel Emphasize subpanel ------------------ The Emphasize feature allows you to control how the results of the search are emphasized in the 3D annotation. There are three possibilities: * **Emphasize with color and opacity:** The search results are emphasized by a color change while all the other parts are displayed with opacity. * **Emphasize with color:** The search results are emphasized by a color change while all the other parts remain displayed without any change. * **Emphasize with isolate:** The search results are emphasized by an “isolate” operation (they remain visible and all the other parts are hidden). A “fit-all” operation is automatically performed in order to zoom to the emphasized parts Depending on the chosen emphasize mode, some additional settings are available: .. |search_emp_color| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page41_img1.png * |search_emp_color| **Emphasize color:** Defines the color used to emphasize the search results. * **Opacity slider:** Defines the opacity value, when the “Emphasize with transparency” mode is selected. * | **Enable blinking:** Activates blinking of the search results. | Blinking is defined by two parameters: * **Period:** Defines the period time (in seconds) for every blink of the parts. * **Number:** Defines the number of blinking that occur for any highlight event. Note: The “Enable blinking” option is not available with the “Emphasize by isolate” mode. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page41_img2.png :align: center Emphasize settings area of the Search panel Advanced settings subpanel -------------------------- .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page42_img1.png :align: center Advanced settings area of the Search edit panel .. |search_icon| image:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page42_img2.png * |search_icon| **Change the search button icon:** * The search icon that appear in the search widget can be changed by selecting a new image from the file system. Search criteria subpanel ------------------------ The Search criteria feature allows you to define: * what search options will be accessible in the Search widget, * search presets. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page42_img3.png :align: center Search criteria settings area of the Search edit panel .. note:: When the Search widget is created in the PDF document, the author must define what search criteria and search presets if any will be proposed to the consumer of the PDF document. It is for example possible to limit the search operation to the names of the parts, or to one or a few attributes. Conversely, the search can be performed on all the attributes linked to the parts from the 3D annotation. There are several search criteria possibilities: * **Part name:** The search will be performed on the names of the parts. * **All attributes:** The search will be performed on all the attributes that are linked to the parts from the 3D annotation. * **Attribute:** The search will be performed on the selected attributes only. .. note:: The Search widget is composed by three different parts: * A field where user will enter the search string * A dropdown list in which the search criteria is selected * A button with Search icon that execute the search operation .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page43_img1.png :align: center In addition to these search criteria, Search presets can be defined. The Search presets enable to execute Search operations with predefined search criteria (Attribute and value). Note: Refer to Search Presets sample to have detailed explanations about the creation of presets. Example of Search operations performed with different criteria ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The Search criteria feature allows you to define what search options will be accessible in the Search widget. * **Search criteria: Part name** .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page44_img1.png :align: center Search criteria (Authoring side) .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page44_img2.png :align: center Search widget (consuming side) .. note:: Consumer can only execute search operation based on the part names .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page44_img3.png :align: center Results when searching for “crankshaft” * **Search criteria: All attributes** .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page45_img1.png :align: center Search criteria (Authoring side) .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page45_img2.png :align: center Search widget (consuming side) .. note:: Consumer can only execute search operation based on all the attributes .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page45_img3.png :align: center Results when searching for “Aluminium” (the Material attribute has some Aluminium values) * **Search criteria: Multiple criteria** .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page46_img1.png :align: center Search criteria (Authoring side) .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page46_img2.png :align: center Search widget (consuming side) .. note:: Consumer can choose what kind of search he wants to perform (all attributes, or only based on the “Material” attribute…) .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page46_img3.png :align: center Results when searching for “rod” as a description Example of Search Presets ~~~~~~~~~~~~~~~~~~~~~~~~~ A search preset is defined by a name and by the description of the search criterion. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page47_img1.png :align: center Search preset definition fields * Search preset creation 1. | Define the preset name in the “Search name” field | **Note:** This name will appear in the Search widget 2. | Define the search criterion in the Search criterion field | **Note:** The criterion must be defined as follows: * The name of the attribute (ie: Material) * The searched value (ie: Aluminiun) .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page47_img2.png :align: center 3. | Click the “Add a predefined search” icon to save the preset | **Note:** The preset appears at the top of list of the Search criteria .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page47_img3.png :align: center 4. Define additional presets if required 5. Select a preset in the list and make a drag and drop to reorder the list. 6. | Click the Delete icon to remove a preset | **Note:** A preset can’t be edited 7. Use the check marks to define what presets and search criteria will be proposed in the search widget .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page47_img4.png :align: center 8. Save the Search widget. * *Executing a search preset* .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page48_img1.png :align: center The 3 presets are proposed To execute the search Preset, click the Search icon .. list-table:: :widths: 1 1 1 :header-rows: 1 * - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page48_img2.png :align: center - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page48_img3.png :align: center - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page48_img4.png :align: center * - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page48_img5.png :align: center - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page48_img6.png :align: center - .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page48_img7.png :align: center Widget > Add language selector ============================== The “Add language selector” feature allows you to: * Define multiple languages within a single PDF document, * Create a widget that enable the document’s consumer to select the language to access to the localized information. The information that can be localized are: * The meta-data linked to components, * The meta-data that have been imported and added to the components, * Text labels that are shown in text fields and buttons. .. note:: The localized information are not supported by the Search widget and by the Table widget. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page49_img1.png :align: center A Language selector widget .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page49_img2.png :align: center PDF document consumed using the English language .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page49_img3.png :align: center PDF document consumed using the French language Creation of a Language selector widget -------------------------------------- 1. Within the Tetra4D Enrich toolbar, choose Widget > Add Language selector. 2. | Drag a rectangle to define the location and the size of the widget. | The rectangle cannot overlap with other Tetra4D Enrich items. | Once the rectangle is defined, the Language selector editor panel appears on the right. 3. Use the frame controllers to resize the widget if needed. 4. Adjust the widget properties to your specifications by selecting the commands in the Edit panel in the right. 5. Rename the “Default Language” name in the Edit panel. 6. | Import languages files and define the languages names in the Edit panel. | **Note:** The languages files are XML files encoded in UTF8. | Refer to the “Export part list” feature for a description of the creation process for the XML files. | Refer to “Localization of attributes and labels” XML file sample for a description of the file format for language definition. 7. Click on the green check button “Validate the widget modifications” icon to save the language selector widget, or 8. Click on the red “X” button “Cancel the Widget modifications” icon to discard the changes. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page50_img1.png :align: center Creation of a Language selector widget .. note:: The import of the languages files is performed when the Language selector is saved. A dialog confirms the result of the import. Definition of the Language selector layout ------------------------------------------ The Editor panel offers several settings to define the layout of the widget and to import languages files. Hover your mouse over any of the buttons to see the specific command. * **Global settings:** Defines the colors and the font information for the widget. * **Available languages:** Imports additional languages files, sets the names of the languages and defines what languages are available in the widget. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page51_img1.png :align: center Edit panel for Language selector Global settings subpanel ------------------------ * **Font settings:** Defines the font and the font size for used in the search widget. * **Font color, Bold, Italic:** Applies to the font used in the search widget. * **Background color:** Defines the background color of the Search widget. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page52_img2.png :align: center Global settings area of the Language selector edit panel Available languages subpanel ---------------------------- The Available languages subpanel allows you to sequentially import files that define languages, and to set the names for the imported languages. .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page52_img3.png :align: center Available languages settings area of the Language widget edit panel * **Import a new language file:** Browse to an existing language file (XML). 1. | Select the language file in the browser and click Apply to confirm the file selection | Note: The selected language file appears in the language selector as a new row. The default name is the file’s name. 2. | To rename a language, double-click it and type-in a new value. | Note: The names of the languages that appear in the selector widget are the names | defined in the Available language list. 3. | To delete an imported language, use the delete icon. | Note: It is not possible to update an already imported language. To modify a | language, delete it first and then import again the language file and rename the language. 4. To reorder the languages in the list, click a language row and drag and drop it to a new position. 5. To define what languages will appear in the language selector widget, check the languages marks. Example of creation of a multiple languages document ---------------------------------------------------- * **Initial document** (title block labels and CAD meta-data are defined in English) .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page53_img1.png :align: center * | **XML file (partial):** Language definition file sample (French). | The list of the parts and labels has been exported with the Export Parts list feature | The localized values have been added in this part list file (all Translation keys) .. code-block:: xml … * Creation of the language selector widget: * Creation of the widget (position and size) .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page54_img1.png :align: center * Import of language file .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page54_img3.png :align: center Default language .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page54_img2.png :align: center Selection of the French language file .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page54_img4.png :align: center Renaming of the languages * Validation of the widget .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page54_img5.png :align: center * Resulting document .. figure:: /_static/images/Tetra4D_ENRICH_2025_Help_ENU/page54_img7.png :align: center