[Gdal-dev] Reading a World file for a Terragen .ter file

[Ray Gardener]

The Terragen driver seems to have a description page already.

As to style, well, GDAL is a library, so the user base is more technical 
than that of a purely runtime app. I can leave details out, but then I 
invariably get questions from lib users, and as a one-person shop I 
can't afford doing any support more than necessary. So the docs tend to 
have a "for the sake of completeness" style. If a fellow dev has to go 
into driver source code to answer interface questions, then something's 
wrong.

If the GDAL toolset users prefer simpler docs, then separate ones should 
be written for them. It's really a different domain. Or the driver notes 
can have Basic/Advanced sections.

Getting back to auxiliary files... there might be a problem because 
Terragen files do have some projection data (the SCAL tag). So it's 
possible to get into a situation where the gridpost spacing doesn't 
agree between the Terragen file and the aux file. It's not like a simple 
bitmap (BMP/PNG/etc.) where there's no georef data at all in the file.

Ray



Brent Fraser wrote:
> Ray,
> 
>   There's the list of formats (one-liners) at
> http://www.gdal.org/formats_list.html, with links to a
> varying amount of information specific to each format.  For
> example the link to the Leveler details is
> http://www.gdal.org/frmt_leveller.html (that particular
> description is a little more programmer oriented than user
> oriented; I was thinking of the type of info in
> http://www.gdal.org/frmt_various.html#PNG might be
> suitable).
> 
> Brent Fraser
> GeoAnalytic Inc.
> Calgary, Alberta
> 
> ----- Original Message ----- 
> From: "Ray Gardener" <rayg at daylongraphics.com>
> To: "gdal-dev" <gdal-dev at lists.maptools.org>
> Sent: Tuesday, September 11, 2007 9:08 AM
> Subject: Re: [Gdal-dev] Reading a World file for a Terragen
> .ter file
> 
> 
>> Brent Fraser wrote:
>>> Ray,
>>>     I'll use one of the other drivers as guide, so it
> should
>>> be consistent.
>>>
>>>     Hmm I was going to see if I should update the
> on-line
>>> doc on the GDAL formats page, but I see that the
> Terraingen
>>> format is not listed (although there is a reference to
>>> Terragen in the Leveler page).  Ray, if you do the
> write-up,
>>> I'll be happy to edit it for my changes...
>> Write-up meaning...? I'm sorry but I don't understand. The
> format list
>> is just a one-line entry per format.
>>
>> Oh, I think the terragen format also needs to be added to
> the GDAL
>> makefile. The text -Dterragen has to be added in that long
> paragraph of
>> driver macro defs.
>>
>> Ray
>>
>> _______________________________________________
>> Gdal-dev mailing list
>> Gdal-dev at lists.maptools.org
>> http://lists.maptools.org/mailman/listinfo/gdal-dev
> 
> 
>