Results 1 to 2 of 2

Thread: Ambiguous description of vgWritePixels/vgReadPixels

  1. #1
    Junior Member
    Join Date
    Sep 2008

    Ambiguous description of vgWritePixels/vgReadPixels


    The OpenVG spec

    "OpenVG Specification
    Version 1.0.1
    Version 1.0 - August 1, 2005
    Amended January 26, 2007"

    reads (page 12: "The vgReadPixels function allows pixel data to be copied ...".

    Together with the code sample ("The code ... is equivalent to the code ...", p. 129), where 'data' is not allocated before use, this sentence may be somewhat misleading to the conclusion that it allows direct access to the pixel data. Especially because vgGetPixels is described in active voice: "The vgGetPixels function retrieves pixel data ...". Shouldn't it therefore be "The vgReadPixels function copies pixel data from the drawing surface..."?

    vgWritePixels is similar.

    Of course it is clear what the function does if one reads the whole description. Sorry for nitpicking but a spec should be as unambiguous as possible, shouldn't it?

  2. #2
    Senior Member
    Join Date
    Feb 2006

    Re: Ambiguous description of vgWritePixels/vgReadPixels

    Oh there's much more ambiguous and confusing stuff than that in the spec - trust me. The worst offenders are mainly things to do with blending, precision, the version string [in version 1.0.1], and fill rules.

    The vgReadPixel() thing is not too bad though - I mean the function takes as an argument the pointer it wants the data put in. Since this pointer is not passed by reference, modifying it to point to the actual drawing surface is impossible (besides - being able to get a pointer to the actual framebuffer is not something that is considered normal behavior now-a-days).

Similar Threads

  1. Replies: 1
    Last Post: 10-22-2011, 10:33 AM
  2. Replies: 2
    Last Post: 11-24-2009, 07:52 AM

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
Proudly hosted by Digital Ocean