PK_ERROR_code_t    PK_PARTITION_receive_deltas
(
--- received arguments ---
PK_PARTITION_t                  partition    --- partition
)


This function receives the deltas for a partition from a file.


Specific Errors:
    PK_ERROR_rollback_not_started  Partitioned rollback is not active
    PK_ERROR_bad_key               Frustrum (FFOPWR) returned FR_bad_name
    PK_ERROR_key_not_found         Frustrum (FFOPWR) returned FR_not_found
    PK_ERROR_cant_open_file        Frustrum (FFOPWR) returned FR_open_fail
    PK_ERROR_file_access_error     Error reading or closing the transmit file,
                                      or writing a delta file
    PK_ERROR_schema_access_error   Error opening, closing, or reading the
                                      schema file
    PK_ERROR_schema_corrupt        Contents of schema file not as expected
    PK_ERROR_wrong_format          File does not have expected transmit format
    PK_ERROR_wrong_version         File transmitted by incompatible version
                                      of modeller
    PK_ERROR_corrupt_file          Invalid transmit file contents
    PK_ERROR_file_read_corruption  Corrupt data read, perhaps an NFS problem
    PK_ERROR_applio_not_registered Application i/o functions not registered
                                     (only relevant if options->transmit_format
                                      is PK_transmit_format_applio)
    PK_ERROR_usfd_mismatch         File has incompatible user-field size
    PK_ERROR_withdrawn_surface     File contains a withdrawn blend surface
    PK_ERROR_FG_receive_failure    Part contains irretrievable foreign
                                      geometry
    PK_ERROR_deltas_not_available  Either the partition was received with
                                      option PK_PARTITION_rcv_deltas_no_c,
                                      or the partition has been modified so
                                      that deltas can no longer be received.


The key, transmit format and user-field options used are the same as the
call to PK_PARTITION_receive which received the given partition.

The frustrum routine FFOPRD is called with guise FFCXMD (transmit file
containing deltas).

Deltas can only be received for a partition if that partition was received
earlier, with option PK_PARTITION_rcv_deltas_later_c, and the pmark which
the partition was at immediately after being received, has not been deleted.

Deltas transmitted from the same or earlier major versions of Parasolid can
be received unless explicitly documented below or in the release notes for
the version of Parasolid in use. Where deltas have been transmitted from an
incompatible version of Parasolid, PK_PARTITION_receive_deltas will return
the error PK_ERROR_wrong_version.

The current limits on the relationship between the transmitting and receiving
versions of Parasolid are summarised in the table below.

lit:


                                 Receiving version

  Transmitting version  |      pre v9.1  v9.1  v10.x
-------------------------------------------------------
                        |
   pre v9.1             |        n/a     n/a    n/a
   v9.1                 |        no      yes    yes
   v10.x                |        no      no     yes


Note: n/a = not applicable
      deltas could not be transmitted/received in versions of Parasolid
      prior to v9.1