#12010: Document the GEOS IO Classes
-------------------------------+--------------------------------------------
          Reporter:  James     |         Owner:  jbronn
            Status:  assigned  |     Milestone:        
         Component:  GIS       |       Version:  1.1   
        Resolution:            |      Keywords:        
             Stage:  Accepted  |     Has_patch:  0     
        Needs_docs:  1         |   Needs_tests:  0     
Needs_better_patch:  0         |  
-------------------------------+--------------------------------------------
Changes (by jbronn):

  * owner:  nobody => jbronn
  * needs_docs:  0 => 1
  * summary:  GEOSGemoentry hex method does not return HEXEWKB => Document
              the GEOS IO Classes
  * status:  new => assigned
  * stage:  Unreviewed => Accepted

Comment:

 !GeoDjango wraps the GEOS library.  Included in the 1.1 release were
 wrappers for the GEOS IO classes: `WKBReader`, `WKBWriter`, `WKTReader`,
 and `WKTWriter` -- unfortunately, this is not in the documentation.
 Regardless, the IO classes allow for finer-grained serialization of
 (HEX)EWKB.  For example:
 {{{
 #!python
 from django.contrib.gis.geos import Point, WKBWriter

 # Creating WKBWriter instance and setting SRID flag to True
 wkb_w = WKBWriter()
 wkb_w.srid = True

 # Also, for 3D support
 #wkb_w.outdim = 3

 pnt = Point(1, 2, srid=4326)

 # This is '0101000020E6100000000000000000F03F0000000000000040'
 hexewkb = wkb_w.write_hex(pnt)
 }}}

 Thus, HEXEWKB support already exists it's just poorly documented.  I'll
 keep this ticket open until I complete the documentation for the GEOS IO
 class interfaces.

-- 
Ticket URL: <http://code.djangoproject.com/ticket/12010#comment:4>
Django <http://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To post to this group, send email to django-updates@googlegroups.com
To unsubscribe from this group, send email to 
django-updates+unsubscr...@googlegroups.com
For more options, visit this group at 
http://groups.google.com/group/django-updates?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to