| |
PK_PARTITION_transmit_o_t |
struct PK_PARTITION_transmit_o_s
{
int o_t_version;
--- version number
PK_transmit_format_t transmit_format;
--- (PK_transmit_format_neutral_c)
PK_LOGICAL_t transmit_user_fields;
--- (PK_LOGICAL_true)
PK_PARTITION_xmt_deltas_t transmit_deltas;
--- (PK_PARTITION_xmt_deltas_none_c)
int transmit_version;
--- (0)
PK_LOGICAL_t transmit_all_attdefs;
--- (PK_LOGICAL_true)
PK_PMARK_array_t pmarks;
--- (NULL, 0)
PK_POINTER_t transmit_indexed_context;
--- (NULL)
PK_transmit_meshes_t transmit_meshes;
--- (PK_transmit_meshes_separate_c)
};
typedef struct PK_PARTITION_transmit_o_s PK_PARTITION_transmit_o_t;
This option structure is supplied to PK_PARTITION_transmit.
PK_PARTITION_transmit
PK_PARTITION_transmit_b
PK_PARTITION_transmit_u
Description of fields:
'transmit_format' Format of the 'file'. Permitted values are
PK_transmit_format_text_c
PK_transmit_format_binary_c
PK_transmit_format_typed_binary_c
PK_transmit_format_neutral_c
PK_transmit_format_indexio_c
PK_transmit_format_applio_c
'transmit_user_fields' PK_LOGICAL_true if user fields are to be transmitted.
'transmit_deltas' Whether to transmit no deltas, all deltas, only
deltas in the 'main line' from the initial pmark to
the current pmark, or delay transmitting deltas until
a call to PK_PARTITION_transmit_delta.
'transmit_version' By default (i.e. 'transmit_version' is zero),
partitions saved using Parasolid 14.0 and later are
backward compatible at least as far as the previous
major version. All information associated with the
part is stored in the saved partition, including
information that may not itself be recognised by
the earlier version. E.g., partitions saved from
15.x would be backward compatible to at least v14.x,
together with all the information they contain.
By explicitly setting 'transmit_version' to a
non-zero integer, an alternative method is used to
achieve backward compatibility. Using this method,
the partition is saved using the precise format of
the previous version. Any information associated
with the partition and not recognised by that
previous version will not be present in the
partition when it is saved.
The integer specifies which version to use. For
example, 141 would indicate Parasolid 14.1, and
130 would indicate Parasolid 13.0. The value must
be at least 120 for transmitting partitions, and
the current version is allowed.
'transmit_all_attdefs' If PK_LOGICAL_false, only attribute definitions used by
the partition (and/or its deltas if 'transmit_deltas'
is not PK_PARTITION_xmt_deltas_none_c) are transmitted.
By default, all the definitions in the session are
transmitted.
'pmarks' Pmarks to override which deltas to transmit. If
'transmit_deltas' is PK_PARTITION_xmt_deltas_none_c
then these 'pmarks' are included; if
'transmit_deltas' is PK_PARTITION_xmt_deltas_all_c
or PK_PARTITION_xmt_deltas_main_c then these 'pmarks'
are excluded. This option cannot be used when
'transmit_deltas' is PK_PARITION_xmt_deltas_later_c.
If any pmark deltas are to be transmitted then the
initial and current pmarks must be included.
Junction pmarks must be transmitted if pmarks in
more than one of their branches are transmitted.
'transmit_indexed_context'
Application specific storage when 'transmit_format'
is PK_transmit_format_indexio_c.
'transmit_meshes' Where any mesh data in the partition are stored.
If this option is PK_transmit_meshes_separate_c
then all mesh data are transmitted to a separate
file with the same 'key', which is opened with
guise FFCXMM (transmit file containing mesh data).
If this option is PK_transmit_meshes_embedded_c
then all mesh data are stored within the partition
file instead, thus allowing data for each mesh to
be individually received when needed using the
receive option 'receive_using_seek' set to
PK_receive_using_seek_yes_c.
To support PK_transmit_meshes_embedded_c,
'transmit_format' must be one of the binary
formats and the Frustrum seek function 'ffskxt'
must be registered using PK_SESSION_register_fru_2.
Partition files with embedded mesh data can still
be received without using seek.
This option is ignored for PK_PARTITION_transmit_b.