Release Notes

SEDRIS SDK Release 4.1.0

July 29, 2006

  1. Introduction
  2. Distribution Packages
  3. Recommended Reading
  4. Installation
  5. SDK Documentation
  6. Applications and Data
  7. Runtime Variables
  8. Included Upgrades
  9. Bug Reports and Feedback
  10. Web Pages

Introduction

Thank you for downloading this release of the SEDRIS Software Development Kit (SEDRIS SDK). The SEDRIS SDK is the development environment for building applications and components that can unambiguously represent and interchange environmental data.

This release has been tested on multiple platforms, such as Linux, Irix, Sun, and Windows 98/Me/NT/2000/XP. For detailed information on platform and compiler versions supported see the Build Kit.

The SDK includes tools useful for accessing, testing, and viewing SEDRIS Transmittal Format (STF) files (also called transmittals). Some of these tools are designed to be used from the command line, but there is also an application that can display 3D geometry present in a transmittal using the OpenGL libraries. More information on these applications is available in the Tools and Utilities page.

This release is compatible with the following SEDRIS technology components:

This release includes the following SEDRIS implementations:

This reference implementation is compliant with the following SEDRIS IS specifications:

The EDCS and SRM will be updated on a regular basis, probably at a faster rate than the other SEDRIS technology components. New versions of these components will easily integrate into your current SEDRIS environment using simple file replacements.

For help, comments, and bug reports please send email to help@sedris.org. If you are an associate, please use se-coders@sedris.org.

Return to: Top


Distribution Packages

This version of the SDK is being made available in multiple distribution formats. In addition to source code, pre-compiled binaries for all supported platforms can be downloaded from the SEDRIS web site (www.sedris.org). You may also download separate distributions of the EDCS SDK and SRM SDK technology components in both source and pre-compiled binaries form.

The following matrix table shows the contents of the different packages for the SEDRIS SDK distributions and the directories in which you will find them:


 

Package and Contents bin:

Executable binary applications

docs:

Documentation, including Release Notes, Migration Guide, and Reference Manual

include:

Headers for SEDRIS Technology Components

lib:

Compiled binary libraries

src:

Source code for SEDRIS Technology Components and Applications

transmittals:

Sample SEDRIS STF transmittals

Complete Source Suite:
  • All SEDRIS Technology Components
  • All SDK Applications
  X     X X
Complete Binary Suite:
  • All SEDRIS Technology Components
  • All SDK applications
X X X X   X

Return to: Top


Recommended Reading

The following table may assist developers in finding the documentation that best matches their needs:

  Release Notes Fixes and Limitations Build Kit Migration Guide Tools And Utilities SDK Reference Manual
New user with
binary distribution
Read Read     Read Read
New user with
source code distribution
Read Read Read   Read Read
Experienced user with
binary distribution
Read Read   Read   Read
Experienced user with
source code distribution
Read Read Read Read   Read

Return to: Top


Installation

The SEDRIS SDK is distributed as a GNU-zipped tar file for Unix systems and a Zip file in Win32 systems. If you have obtained a source distribution, you will need to build the SDK after installation in order to run the applications and test your setup. Instructions for building the SDK are located in the Build Kit, along with instructions on Testing the Build. If you have a binary distribution, you can proceed to Testing the Build after finishing the installation.

Note: If you have an earlier version of the SDK and you haven't changed its default installation directory, you may want to do it now because this version of the SDK may overwrite it.

To install, extract the contents of the compressed file:

Unix

Use the "tar" and "gzip" commands to extract the contents of the SDK:

gunzip -c sdk_file.tgz | tar xf -
using the appropriate filename for "sdk_file.tgz".

If you have GNU tar installed, you can use the following command instead:

tar xzf sdk_file.tgz

Win32

Use WinZip or other decompression utility to extract the contents of the downloaded file.

See the Build Kit page for information on building the SDK, testing the build, and linking your applications and/or libraries against the libraries in this SDK.

Note that the file name for binary releases includes the OS/System architecture type as part of the name. After extracting the software, users should see a top-level "sedris" directory. Binary releases associated with different OS/architecture can be installed on a common "sedris" directory. This is to allow users who work on several platforms to install all the releases under a common "sedris" directory in a shared network drive. In that case, on each installation, the non-OS-specific files are replaced by the new release and the OS specific libraries and executables are stored under their respective sub-directories under the "lib" and "bin" directories discriminated by their platform/version/architecture combination.

Return to: Top


SDK Documentation

The SDK Documentation is divided into the following areas:

Release Notes (this document)
Describes the capabilities of this release, its contents, and supported platforms and compilers.
Build Kit
Details the build options and procedures for compiling and linking the software, how to test the build, and how to link applications and libraries against the SDK.
Fixes And Limitations
Describes the fixes and known limitations of this release.
SDK Reference Manual
Provides links to detailed documents for the DRM, EDCS, SRM, API, and STF technology components.
Tools and Utilities
Describes the tools and utilities included with this release, such as Depth and Model Viewer.
Migration Guide
Provides information on procedures and utilities available to migrate applications from SDK Release 3.1.x to Release 4.0.

Return to: Top


Applications and Data

This release includes several applications and sample data that demonstrate the use of the SEDRIS SDK to create and access STF files.

Applications (also see Tools and Utilities):

Sample STF transmittals and related files:

test.stf
Contains one <Model> with 3 polygons resembling a famous mouse. Uses LSR for its environment. There are no textures, features, or grids. There is one polygon in the <Environment Root> (green color).
sample_comm.stf
Contains a model of a communications console. It demonstrates texture mapping.
sample_chair.stf
Contains a somewhat complex model of an office chair.
atm_grib.stf
Contains sample atmospheric data (wind speed and temperature) stored using the <Property Grid> class.
sedris.rsl
A sample SEDRIS resolution file for resolving transmittal identifications in Uniform Resource Name (URN) to explicit transmittal root file names. This resolution file can be used in conjunction with the transmittals generated by the itr_test utility application to resolve all the necessary transmittal references. Redefine the root path in the sedris.rsl to the one in use.

Return to: Top


Runtime Variables

This section describes the following environment variables that are available for users to configure their runtime environment:

Return to: Top


Included Upgrades

The first entry of the table below lists the SEDRIS Change Requests (SCRs) implemented in this release. An SCR is the means by which users make their requests for SEDRIS technology changes as either a functional enhancement or a software problem. Users can make such requests via the SCR Form Web Site. The SEDRIS Associates can review the status of the SCRs at the SEDRIS website while the non-associates can obtain their status by sending a request for specific SCRs to se-scrccb@sedris.org.

Please see Fixes And Limitations for detailed information on software fixes and known limitations/defects.


The following table entries provide a summary of the major improvements in each one of the SEDRIS technology components and changes to miscellaneous items such as the build environment and compiler support.

SEDRIS Change Requests (SCRs) addressed None.
DRM
  • Compliant with ISO FDIS SEDRIS Part 1 - Data Representation Model (DRM) (ISO/IEC 18023-1)
  • <Access>
    Instances of the Legal Constraints and Security Constraints classes that replaced <Access> are now required to always be components of an Identification instance. Consequently, for any object X that previously had an <Access> component, the Identification component of X will now have the corresponding Legal Constraints and / or Security Constraints instances as components. In a 4.0.x to 4.1 conversion, if X did not previously have a <Description> component, X would have a new Identification component added for this purpose.
  • Citation
    If a Citation instance C was previously a component of an object X, where X is an instance of any class other than Keywords or Source, C shall instead be a component of the Identification component of X, unless X was a <Cross Reference> instance. (In that case, C shall not be converted.)
  • Conformal Behaviour
    Consult the clarified constraints on this class to ensure that instances of it are being used in a valid context.
  • Literal, State Data, State Related Features, State Related Geometry
    In conversion from 4.0.x to 4.1, the old value_characteristic union member has been removed in compliance with EDCS. This was not previously a valid case, so during conversion an occurrence of this will generate an error message.
  • The universal flag of a topology volume has been moved from the shell class to the volume class.
  • Property Description, Property Value
    The inheritance of Property instances are explicitly stated through the new apply_property_inheritance field of <Property>.
  • Responsible Party
    For every Responsible Party component R of an object X, the relationship between X and R shall now have a Role Data link object, taking over what was previously the role field of Responsible Party.
SRM
  • Compliant with the ISO FDIS Spatial Reference Frame (SRM) (ISO/IEC 18026)
  • Compliant with the ISO FDIS Spatial Reference Frame C Language Binding (ISO/IEC 18042-4)
EDCS
  • Compliant with the ISO FDIS Environmental Data Encoding Specification (EDCS) (ISO/IEC 18025)
  • Compliant with the ISO FDIS Environmental Data Encoding Specification C Language Binding (ISO/IEC 18041-4)
  • This version of EDCS is the implementation of the ISO EDCS specificaion FDIS version. Therefore the concepts defined herein will be consistent with that specification.
  • EDCS_Attribute_Value's EDCS_Value_Characteristic_Code field has been removed. Any object needing to specify this information shall specify a <Property Characteristic> component instead.
Transmittal Access C API
  • Compliant with the ISO FDIS SEDRIS (Transmittal Access) C Language Binding (ISO/IEC 18024-4)
  • Compliant with the ISO FDIS SEDRIS Part 3 - SEDRIS Transmittal Format (STF) (ISO/IEC 18023-3)
  • The storage and retrieval of Mesh Face Table Data is now performed with 2 new functions.
Transmittal Access C++ API
  • Compliant with the ISO FDIS SEDRIS Part 3 - SEDRIS Transmittal Format (STF) (ISO/IEC 18023-3)

Return to: Top


Bug Reports and Feedback

Questions, comments, and bug reports should be sent to help@sedris.org.

If you are an associate, please send email to se-coders@sedris.org.

Return to: Top


Web Pages

These links require Internet access:

Return to: Top


Copyright © 2006 SEDRIS