GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  VISIO (3)

.ds Aq ’

NAME

Visio - Perl extension mainpulating XML based Visio files

CONTENTS

SYNOPSIS

To create a viso vdx file, create multiple pages, reorient one of the pages:



  my $v = new Visio();
  $v->set_title(wabla wabla);
  $v->set_timeCreated();
  $v->set_timeSaved()

  my $page = $v->addpage();
  $page->set_name(my page);
  $page->set_heightWidth(8,11);

  my $page2 = $v->addpage();
  $page2->set_name(my page2);

  $v->toFile(myvisofile.vdx);



ABSTRACT



  Visio is an alpha stage library to create and manipulate Microsoft Visio
  drawings.



DESCRIPTION



  Visio is an alpha stage library to create and manipulate Microsoft Visio
  drawings.

  Currently it can only create drawings from scratch, and can not
  create a usable object model from a pre-existing file.

  The Visio module is however able to extract stencils from pre-existing
  files and insert them into your new drawings. This is helpfull as
  it is fairly difficult to make a nice drawing on your own via the
  current Visio perl module API.

  This is my first public Perl module, and Im sure there are tons of
  mistakes. Please feel free to communicate any design flaws or reworking
  you may feel would make Visio more usable and approachable.



Document Methods

new()

A new Visio document is created using the new method:



 my $vDoc = new Visio();



By default the document is completely empty and the document creator is set to ’perl-visio’. This can be overwritten by use of the set_creator method.

toString()

Visio document is returned as an XML string.



 my $vString = $vDoc->toString;



    toFile($filename)

Visio doc is written out to an XML file.



 $vDoc->toFile(myfile.vdx);



toXmlDoc()

libxml2 doc element is returned



 $vDoc->toXmlDoc();



    set_title($title)

Sets Document title



 $vDoc->set_title(my title);



    set_subject($subject)

Sets Document subject



 $vDoc->set_subject(my subject);



    set_manager($manager)

Sets Document manager field



 $vDoc->set_manager(my manager);



    set_company($company)

Sets company filed in document.



 $vDoc->set_company(my company);



    set_desc($desc)

Sets Document description.



 $vDoc->set_desc(my really good description);



    set_creator($creator)

Sets Document creator field.



 $vDoc->set_creator(just me);



    set_timeCreated($visoTimeString)

Set’s document time created information. If time is not passed, the current time (UTC) is set.



 $vDoc->set_timeCreated();



    set_timeSaved($visioTimeString)

Set’s document time saved information. If time is not passed, the current time (UTC) is set.



 $vDoc->set_timeSaved();



    visio_timeformat($time)

Takes in argument of $time, which is in the format of the perl time() function. Returns a $visioTimeString formatted string.



 $vDoc->set_timeCreated(Visio::visio_timeformat(time()));

 is equivilent to:

 $vDoc->set_timeCreated();



find_master_dom()

searches the visio masters (stencils). filters can be specifed:



 $vDoc->find_master_dom({name=>myrectangle})



returns a libxml nodelist object of all stencils that had name ’myractangle’. Not specifying filters returns all stencils.

filters avaliable:

name

Page Methods

addpage()

A new Visio page is created in a Visio document.



 my $vPage1 = $vDoc->addpage();



By default the document is completely empty and the document creator is set to ’perl-visio’. This can be overwritten by use of the set_creator method.

    set_name($name)

Sets the name of the page



 $vPage->set_name(mypage);



    set_heightWidth($height,$width)

Sets a page’s height and width. In inches by default:



 $vPage->setheightWidth(8,11);



create_pageSheet();

creates a pageSheet method if needed under this page



    my $pageSheet = $vPage->create_pageSheet();



PageSheet methods

For the most part one shouldn’t need to directly use these methods

    new($parentNode)

new creates (if one does not already exist) a new child PageSheet element node under $parentNode, which is a libxml2 object.

    get_node

returns the PageSheet libxml2 node



 my $pageSheetNode = $pageSheet->getnode();



    create_pageProps

creates a PageProps object and element under the current PageSheet

PageProps methods

For the most part one shouldn’t need to directly use these methods

    new($parentNode)

new creates (if one does not already exist) a new child PageProps element node under $parentNode, which is a libxml2 object.

    get_node

returns the PageProps libxml2 node



 my $pagePropsNode = $pageProps->getnode();



    set_PageWidth($width)

sets the page width of this PageProps node. Default unit is in inches.



 $pageProps->set_PageWidth($width);



    set_PageHeight($height)

sets the page height of this PageProps node. Default unit is in inches.



 $pageProps->set_PageHeight($height);



    EXPORT

None by default.

SEE ALSO

If you have a mailing list set up for your module, mention it here.

AUTHOR

Aamer Akhter, <aakhter@cisco.com> <aakhter@gmail.com>

COPYRIGHT AND LICENSE

Copyright 2005 by Aamer Akhter

This library is free software; you can redistribute it and/or modify it under the same terms as in LICENSE and MSPATENTLICENSE files.



 "This product may incorporate intellectual property owned by
 Microsoft Corporation. The terms and conditions upon which Microsoft
 is licensing such intellectual property may be found at
 http://msdn.microsoft.com/library/en-us/odcXMLRef/html/odcXMLRefLegalNotice.asp"



Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 VISIO (3) 2005-08-13

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.