view release on metacpan or  search on metacpan

README  view on Meta::CPAN

     $drawing = File::Drawing->retrieve($drawing_number, @options);

     $error = $drawing->release(@options);

     $error = $drawing->revise(@options);

     $date = $drawing->dod_date($sec, $min, $hour, $day, $month, $year);
     $drawing_number = $$drawing->dod_drawing_number( );

     $pm = $drawing->number2pm($drawing_number, $repository); 
     $drawing_number = $drawing->pm2number($drawing_number, $repository); 

     $drawing->obsolete($drawing_number, $repository);
     $drawing->broken($drawing_number, $repository);
     ($file, $backup_file) = $drawing->backup($drawing_number, $repository, $dir);

    Generally, if a subroutine will process a list of options, "@options",
    that subroutine will also process an array reference, "\@options",
    "[@options]", or hash reference, "\%options", "{@options}". If a
    subroutine will process an array reference, "\@options", "[@options]",
    that subroutine will also process a hash reference, "\%options",
    "{@options}". See the description for a subroutine for details and
    exceptions.

DESCRIPTION
    The "File::Drawing" program module uses American National Standards for
    drawings as a model for storing data. Commercial, governement and casual
    orgainizations have stored information over the centuries as drawings.
    Drawings probably evolved from the census that the Roman's rulers,
    started back when Rome was a little frontier town. In other words, the
    practices of the drafting displines have evolved over time and have
    stood the test of time. Any deviation must be a crystal clear advantage.
    Many of the practices are in place to avoid common and costly human
    mistakes that obviously a computerize drafting system will not make. A
    good approach is to make the computerized data structure optimum for
    computers and have the computer render the computerized data into a form
    that meets the drafting standards. The "File::Drawing" program module,
    uses the Perl program module name as a drawing repository, drawing
    number combination. The contents of the drawing is contained in the
    program module file. The <File::Drawing> program module established
    methods to retrieve contents from a program module drawing file, create
    an Perl drawing object with the contents, and methods to release and
    revise the contents in a program module drawing file from a Perl drawing
    object. Other popular methods for computerize date are the SQL and XML.
    Perl has a wide range of program modules using these approach.

    In this time in history, the Drawings are highly standardize and even
    subject to Internationl standarization agreements. The Drawing Sheet
    Size and Format conform to ANSI Y14.1-1975 or its successor. The drawing
    has a box with zone numbers running right to left alon the top and
    bottom, and zone letters running bottom to top along the sides. There is
    a section inside the box, lower right corner with the blocks for such
    things as the title, drawing number, current revision, authoriztion, and
    sheet number. There is an expandable four column table in the top right
    corner to record the revision history.

    The data in a drawing may be divided into two parts as follows:

    contents
        The contents proper is the text and graphics inside the drawing
        boundaries, not including the lower right corner blocked off area
        containing the title and the upper right corner revision history.
        The contents should conform to standards for contents such as ANSI
        X3.5-1970, Flowchart Symbols and their Usage in Information
        Processing.

    white tape
        The white tape is the drawing information that is not the contents
        such as the drawing number, revision, revision history. This is meta
        type data about the contents.

        The term white tape is derived from a common practice of writing
        part numbers and drawing numbers on white tape and affixing the
        white tape to parts and drawing media such as magnetic tape, disks,
        etc. There are vendors that sell gadgets whereby you can punch in
        text and it will generate tape with the text to affix to parts and
        drawings.

    The "File::Drawing" program module provides a format for very specific
    white tape data and 100% open, unspecified contents.

    The white tape data include information needed to support rendering of
    the drawings for delivery to other activities such as other commerical
    and industry activities and government activities.

    For example, for delivery to the US DOD, the drawing number must meet
    very specific requirements. The drawing number must comply to
    DOD-STD-100C, Drawing Practices following requirements

    401.4. *Drawing Number.* The drawing number consists of letters, numbers
    or combination of letters and numbers, which may or may not be separated
    by dashes. The number is assigned to a particular drawing for
    identification purposes by the design activity.

    402.5 *Drawing number.* The drawing number shall not exceed 15
    characters. These characters may include numbers, letter, and dashes
    with the following limitations:

    a. Letters "I", "O', "Q", "S", "X", and "Z" shall not be used; however
    letters "S" and "Z" may be used only if they are a part of the existing
    drawing numbering system. THey shall not be used in the development of
    new drawing numbering systems. Letters shall be upper case (capital
    letters).

    b. Numbers shall be arabic numberals. Fractional, decimal and Roman
    numberals shall not be used.

    c. Blank spaces are not permitted.

    d. Symbols such as: parentheseis, asterisks, virgule, degree, plus,
    minus shall not be used, except when referencing the Government or
    non-governemnt standardization document whose identification contains
    such symbol

    e. The FSCM number, drawing format size letter, and drawing revision
    letter (see paragraphs 503.2 and 602.3) are not considered part of the
    drawing number

    f. A system based on a significant numbering system or a sequentially
    assigned non-significant numbering system designed to preclude
    duplication is acceptable.