CHANGE STRUCTURE REFERENCES(3P) — SUNPHIGS LIBRARY

NAME

CHANGE STRUCTURE REFERENCES − change all references to a specified structure to instead refer to another specified structure

SYNOPSIS

C Syntax

void
pchangestructref ( orig_struct_id, result_struct_id )
Pintorig_struct_id;original structure identifier
Pintresult_struct_id;result structure identifier

FORTRAN Syntax

SUBROUTINE pcstrf ( OLDSID, NEWSID )
INTEGEROLDSIDoriginal structure identifier
INTEGERNEWSIDresulting structure identifier

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

CHANGE STRUCTURE REFERENCES modifies the arrangement of the structure network by changing all references to a specified structure (the original structure identifier) to refer to a different structure (the resulting structure identifier) instead. The subroutine changes both EXECUTE STRUCTURE references and any posting to a workstation.

The effect is to substitute the resulting structure for the original structure wherever it appears in a structure network or on a workstation posting.

C Input Parameters

orig_struct_id
CHANGE STRUCTURE REFERENCES changes the references to this structure.

result_struct_id
Specifies the structure the original structure references will point to when CHANGE STRUCTURE REFERENCES returns.

FORTRAN Input Parameters

OLDSID
CHANGE STRUCTURE REFERENCES changes the references to this structure.

NEWSID
Specifies the structure the original structure references will point to when CHANGE STRUCTURE REFERENCES returns.

Execution

The CHANGE STRUCTURE REFERENCES subroutine changes all references to the original structure identifier to refer instead to the resulting structure identifier. Structure references are established by creating EXECUTE STRUCTURE elements or by posting a structure. A single call to CHANGE STRUCTURE REFERENCES changes both types of references to the specified structure. The following details how the subroutine changes each type of structure reference. How EXECUTE STRUCTURE References are Changed

CHANGE STRUCTURE REFERENCES changes all EXECUTE STRUCTURE elements throughout the Central Structure Store that reference original structure identifier so that they reference resulting structure identifier instead. Any references to resulting structure identifier that already exist when CHANGE STRUCTURE REFERENCES is called will not be changed by the subroutine.

If resulting structure identifier does not exist when the subroutine is called, it will be created as an empty structure and the original structure identifier references assigned to it.

If original structure identifier and resulting structure identifier specify the same structure, the subroutine does not take any action. How Posted Structures are Changed

If original structure identifier is posted to a workstation when CHANGE STRUCTURE REFERENCES is called, the subroutine unposts original structure identifier and posts resulting structure identifier with the same priority that original structure identifier had.

If resulting structure identifier is posted when CHANGE STRUCTURE REFERENCES is called, it will remain posted and its priority will not change. If original structure identifier is also posted, it will be unposted.

Changes in a posted structure network are processed immediately and may immediately affect the display. The actual visual effects that appear on the display surface will depend on the workstation’s current display update state.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

Museum