Changeset 717

Timestamp:

Feb 18, 2024, 3:24:40 AM (14 months ago)

Author:

Lewis Rosenthal

Message:

EN: Reformatted LGPL IPF to avoid xmp tags which may generate unnecessary scrollbars.

Base 'scale' panel redone in GBM IPF (thanks to Alfredo).

ES: More help updates.

Location:

trunk/Lucide

Files:

• lng/lgpl21.ipf (modified) (3 diffs)
• lng/lucide_es.ipf (modified) (3 diffs)
• plugins/lugbm/doc/gbm_en.ipf (modified) (10 diffs)

trunk/Lucide/lng/lgpl21.ipf ¶

@@ -147 +147 @@
 writing it).  Whether that is true depends on what the Library does
 and what the program that uses the Library does.
-  
+
 :p.1. You may copy and distribute verbatim copies of the Library's
 complete source code as you receive it, in any medium, provided that
@@ -477 +477 @@
 "copyright" line and a pointer to where the full notice is found.
 
-:xmp.
-    &lt.one line to give the library's name and a brief idea of what it does.&gt.
-    Copyright (C) &lt.year&gt.  &lt.name of author&gt.
-
-    This library is free software; you can redistribute it and/or
-    modify it under the terms of the GNU Lesser General Public
-    License as published by the Free Software Foundation; either
-    version 2.1 of the License, or (at your option) any later version.
-
-    This library is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-    Lesser General Public License for more details.
-
-    You should have received a copy of the GNU Lesser General Public
-    License along with this library; if not, write to the Free Software
-    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-:exmp.
+:lm margin=4.
+:font facename='System Monospaced' size=13x1.
+:p.&lt.one line to give the library's name and a brief idea of what it does.&gt.
+.br
+Copyright (C) &lt.year&gt.  &lt.name of author&gt.
+
+:p.This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+:p.This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Lesser General Public License for more details.
+
+:p.You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+:font facename=default.
+:lm margin=1.
 
 :p.Also add information on how to contact you by electronic and paper mail.
@@ -502 +505 @@
 necessary.  Here is a sample; alter the names&colon.
 
-:xmp.
-    Yoyodyne, Inc., hereby disclaims all copyright interest in the
-    library `Frob' (a library for tweaking knobs) written by James Random Hacker.
-
-    &lt.signature of Ty Coon&gt., 1 April 1990
-    Ty Coon, President of Vice
-:exmp.
+:lm margin=4.
+:font facename='System Monospaced' size=13x1.
+:p.Yoyodyne, Inc., hereby disclaims all copyright interest in the
+library `Frob' (a library for tweaking knobs) written by James Random Hacker.
+
+:p.&lt.signature of Ty Coon&gt., 1 April 1990
+.br
+Ty Coon, President of Vice
+:font facename=default.
+:lm margin=1.
 
 :p.That's all there is to it!

trunk/Lucide/lng/lucide_es.ipf ¶

@@ -6 +6 @@
 :h1 res=001 name=intro
     x=left y=bottom width=100% height=100%.Sobre Lucide
-
 :artwork align=center name='lucidelogo.bmp'.
-:hp2.Lucide:ehp2. es un visor de documentos de arquitectura modular con soporte
-para diversos formatos de archivo, principalmente el PDF (Portable Document
-Format) de Adobe. Ofrece una arquitectura de m¢dulos basados en SOM que
-permite a terceros programadores a€adir f cilmente m¢dulos con los que dar
+:p.:hp2.Lucide:ehp2. es un visor de documentos de arquitectura modular con
+soporte para diversos formatos de archivo, principalmente el PDF (Portable
+Document Format) de Adobe. Ofrece una arquitectura de m¢dulos basados en SOM
+que permite a terceros programadores a€adir f cilmente m¢dulos con los que dar
 soporte a formatos de archivo adicionales.
 
@@ -71 +70 @@
 :p.
 .im lgpl21.ipf
-:p.
 
 
@@ -3440 +3438 @@
 Los m¢dulos que incluyan su propia ayuda aparecer n tras esta p gina y deber¡an
 listarse en el ¡ndice de contenido de esta gu¡a.
-
 :euserdoc.

trunk/Lucide/plugins/lugbm/doc/gbm_en.ipf ¶

@@ -2 +2 @@
 :docprof toc=123456.
 :title.Generalised Bitmap Plugin for Lucide
-.* rev 2024-01-28-001
+.* rev 2024-01-29-001
 .* ----------------------------------------------------------------------------
 :h1 res=10001 name=gbm_intro
     x=left y=bottom width=100% height=100%.About the GBM plugin for Lucide
-.*:artwork align=center name='lucidelogo.bmp'.
-:p.The Generalised Bitmap Module (GBM) plugin for :hp2.Lucide:ehp2. is an
-extension which provides access to all bitmap formats supported by :link
-reftype=hd res=10004.GBM:elink.. The following :hp2.Lucide:ehp2. features are
-currently supported by the plugin:
+The Generalised Bitmap Module (GBM) plugin for :hp2.Lucide:ehp2. is an
+extension which provides access to all bitmap formats supported by
+:link reftype=hd res=10004.GBM:elink.. The following :hp2.Lucide:ehp2. features
+are currently supported by the plugin:
 
 :ul compact.
@@ -24 +23 @@
 :li.Selectable quality scaling algorithms for improved appearance vs
 performance
-:li.Background rendering for Multi-page images 
+:li.Background rendering for Multi-page images
 :eul.
 
@@ -43 +42 @@
 :ent.
 
-:p.:ul compact.
+:ul compact.
 :li.:link reftype=hd res=10002.License:elink.
 :li.:link reftype=hd res=10003.Installation:elink.
@@ -50 +49 @@
 :li.:link reftype=hd res=10110.Notices:elink.
 :eul.
-:p.
+
 
 .* ............................................................................
 :h2 res=10002 name=gbm_license
     x=left y=bottom width=100% height=100%.License
-
-:p.Copyright &bx0012. 2006-2012 Heiko Nitzsche
+Copyright &bx0012. 2006-2012 Heiko Nitzsche
 
 :p.This software is provided 'as-is', without any express or
@@ -67 +65 @@
 
 :dl tsize=3 break=none.
-:dt.1. 
+:dt.1.
 :dd.The origin of this software must not be misrepresented; you must not claim
 that you wrote the original software. If you use this software in a product, an
 acknowledgment in the product documentation would be appreciated but is not
 required.
-:dt.2. 
+:dt.2.
 :dd.Altered source versions must be plainly marked as such, and must not be
 misrepresented as being the original software.
-:dt.3. 
+:dt.3.
 :dd.This notice may not be removed or altered from any source distribution.
 :edl.
@@ -105 +103 @@
 is also an example file included in the package. You may use the &numsign. sign
 to start a comment. Everything after this sign is ignored on this line. If the
-configuration file does not exist, the plugin will use the default options. 
+configuration file does not exist, the plugin will use the default options.
 
 
@@ -302 +300 @@
 :p.This defines the scaling (sizing) algorithm
 
-:p.By default, the simple scaler is used. This is the fastest scaler which uses
-less resources compared to all other scalers while providing acceptable quality
-for normal viewing.
-
 :p.:hp2.Syntax&colon.:ehp2.
 
@@ -319 +313 @@
 :exmp.
 
+:p.:hp2.Scaling:ehp2. is creating a new version of an image with a different
+size, e.g. what is stored on disk vs. what is displayed on screen. While not
+necessarily the case, scaling is generally done :hp2.resampling:ehp2. i.e.
+generating pixels for the new image that were not present in the original one.
+Both operations can be prepended with up- when generating bigger images, or
+with down- when generating smaller images.
+
+:p.When upsampling an image, the main question is, what the color of the new
+pixels surrounding the original ones will be. When downsampling, the question
+is what pixels will be retained, or what color any new ones will be. This process
+involves a trade-off between efficiency, smoothness, sharpness and speed. Each
+scaler algorithm is a different answer to the question of how to best do it.
+
+:p.There are many different possibilities, and these operations are not
+lossless: typically, if you downscale an image and then upscale the resulting
+image back, you will get a new image, slightly different from the original.
+
+:p.:hp2.Convolution:ehp2. is a resampling technique that defines a general
+principle for interpolation: a function is calculated to reach values
+corresponding to the pixels in the original image, and multiplied by another
+one known as "the kernel" to interpolate new pixels. The interpolation kernel
+k(i) defines the list of neighbors to be considered and the weight assigned to
+each neighbor in the list for calculating the value of the new pixel.
+
+:p.Within the convolution framework, it is easy to use different kernels and
+thus vary the type of interpolation. The simplest kernel is the "nearest
+neighbor" kernel, which corresponds to a box.
+
+:p.By default, in GBM the simple scaler is used. This is the fastest scaler
+which uses less resources compared to all other scalers while providing
+acceptable quality for normal viewing.
 
 :p.Related&colon.
 
-:p.:ul compact.
+:ul compact.
 :li.:link reftype=hd res=10010.simple:elink.
 :li.:link reftype=hd res=10011.nearestneighbor:elink.
@@ -337 +362 @@
 :eul.
 
+:p.To know more about scaling and resampling:
+
+:ul compact.
+:li.https&colon.//clouard.users.greyc.fr/Pantheon/experiments/rescaling/index-en.html
+:li.https&colon.//medium.com/fourier-imaging/resampling-of-images-and-video-sequences-f27997c4d65a
+:li.https&colon.//www.graphicon.ru/oldgr/en/research/resampling/index.html
+:eul.
+
 .* ............................................................................
 :h4 res=10010 name=gbm_config_scaler_simple
@@ -383 +416 @@
 :p.B-spline is not an interpolative filter. It is an approximating function
 which passes near the sampling points, but does not go through them. As a
-reslult of the low-pass (blur) characteristics of the process, the image
+result of the low-pass (blur) characteristics of the process, the image
 undergoes considerable smoothing (softening).