SVG::Rasterize::Regexes - Commonly used regular expressions
SVG::Rasterize::Regexes
Version 0.003007
This package offers a set of regular expressions for export. Many of them are precompiled into downstream expressions, therefore changing them would probably not have the desired outcome. Therefore they are also not documented in full detail, see the code for the details.
A
P
Floating point number expressions are divided into A (for attribute) and P (for property) versions, e.g. $RE_NUMBER{A_FLOAT} and $RE_NUMBER{P_FLOAT}. The reason for that is that apparently, the CSS specification prohibits floating point numbers in scientific notation (e.g. 3e-7). However, the XML standard allows such numbers in attribute values. Currently, however, SVG::Rasterize does not make use of this distinction and always uses the A version. Therefore, it will not complain if you provide a number in scientific notation within a style attribute although strictly, this is forbidden by the specification. This may or may not change in the future.
$RE_NUMBER{A_FLOAT}
$RE_NUMBER{P_FLOAT}
CSS
3e-7
XML
SVG::Rasterize
style
p
w
s
The regular expressions from this package might be used to build more complex expressions, but are also used to validate values which should match the expression fully (not a substring). Therefore, some expressions have p (for pure) and w (for white space) versions. If $RE is an expression then $p_RE will be qr/^$RE$/, and $w_RE will be qr/^$WSP*$RE$WSP*$/.
$RE
$p_RE
qr/^$RE$/
$w_RE
qr/^$WSP*$RE$WSP*$/
The validation expressions for path data and points lists of polyline and polygon elements also have a s (for start) version. The background is that they are supposed to be rendered up to the erroneous part. If they match fully is only found out when they are split up into parts.
polyline
polygon
Two expressions are exported directly as scalars, the other ones are organized in a set of hashes:
$WSP = qr/[\x{20}\x{9}\x{D}\x{A}]/
This is one white space character as defined by the SVG specification (inherited from XML I suppose). The character class consists of SPACE, TAB, CR, and LF.
SVG
SPACE
TAB
CR
LF
$CWSP = qr/(?:$WSP+\,?$WSP*|\,$WSP*)/
White space or comma, possibly surrounded by white space.
%RE_PACKAGE
Currently, this hash contains only one entry:
$RE_PACKAGE{p_PACKAGE_NAME} = qr/^$package_part(?:\:\:$package_part)*$/;
where $package_part is a lexical variable with the value qr/[a-zA-Z][a-zA-Z0-9\_]*/.
$package_part
qr/[a-zA-Z][a-zA-Z0-9\_]*/
Package names given to some methods in this distribution have to match this regular expression. I am not sure which package names exactly are allowed. If you know where in the Perl manpages or the Camel book this is described, please point me to it. If this pattern is too strict for your favourite package name, you can change this variable.
%RE_XML
Expressions for XML Names and Nmtokens, see http://www.w3.org/TR/2006/REC-xml11-20060816/#xml-names. Currently, only the ASCII subset of allowed characters is allowed here because I do not know how to build efficient regular expressions supporting the huge allowed character class.
ASCII
%RE_URI
Expressions to parse URIs. Largely inspired by an expression given in RFC2396. These expressions can be used to recognize a URI and split it into its pieces, but not for validation. It is enough for now, though.
URI
%RE_NUMBER
Contains expressions for integer and floating point numbers. The reasons for building own regular expressions are that the format is specified in terms of a Backus Naur form in the SVG specification, e.g. here: http://www.w3.org/TR/SVG11/coords.html#TransformAttribute. Note that these expressions allow leading zeroes like '00030' or '000.123'.
%RE_LENGTH
Lengths in SVG consist of a number and optionally a length unit. See Units in SVG::Rasterize.
%RE_PAINT
Expressions for paint attributes (see http://www.w3.org/TR/SVG11/painting.html#SpecifyingPaint).
paint
%RE_TRANSFORM
Regular expressions required to parse values of the transform attribute. These expressions are constructed according to the Backus Naur form at http://www.w3.org/TR/SVG11/coords.html#TransformAttribute.
transform
%RE_VIEW_BOX
Regular expressions required to parse values of the viewBox and preserveAspectRatio attributes.
viewBox
preserveAspectRatio
%RE_PATH
Regular expressions required to parse path data strings. These expressions are constructed according to the Backus Naur form at http://www.w3.org/TR/SVG11/paths.html#PathDataBNF.
%RE_DASHARRAY
Regular expressions required to parse values of the stroke-dasharray property.
stroke-dasharray
%RE_POLY
Regular expressions required to parse values of the points attribute of polyline and polygon elements. These expressions are constructed according to the Backus Naur form at http://www.w3.org/TR/SVG11/shapes.html#PointsBNF.
points
%RE_TEXT
Regular expressions required to parse values associated with text that have a more complex structure, e.g. the font-size attribute.
font-size
EXPORT_TAGS
The following export tags can be used like
use SVG::Rasterize::Regexes qw(:whitespace);
:all
:whitespace
$WSP and $CWSP.
$WSP
$CWSP
:attributes
%RE_NUMBER, %RE_LENGTH, %RE_PAINT, %RE_TRANSFORM, %RE_VIEW_BOX, %RE_PATH, %RE_DASHARRAY, %RE_POLY.
Lutz Gehlen, <perl at lutzgehlen.de>
<perl at lutzgehlen.de>
Copyright 2010 Lutz Gehlen.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
To install SVG::Rasterize, copy and paste the appropriate command in to your terminal.
cpanm
cpanm SVG::Rasterize
CPAN shell
perl -MCPAN -e shell install SVG::Rasterize
For more information on module installation, please visit the detailed CPAN module installation guide.