X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=cf%2Fimages;h=ab8dc24ed8c04f81efc0f87f0d8f6825e0d560cb;hb=b5b7b2641b00a18b53c48a1335846133f1d53168;hp=e37ccc0a6ccc91d0f78e568ede3c952cd49ecd52;hpb=d107850afa414b96c304b2a5a0c915f70f224dcc;p=libucw.git

diff --git a/cf/images b/cf/images
index e37ccc0a..ab8dc24e 100644
--- a/cf/images
+++ b/cf/images
@@ -2,37 +2,71 @@
 
 ######## General parameters #####################################################
 
-Images {
+ImageLib {
+
+# Default tracing level (0 to disable)
+Trace			0
+
+# Limits for image allocation
+ImageMaxDim		0xffff		# Maximum width/height (at most 64k-1)
+ImageMaxBytes		256M		# Maximum size in bytes
+
 }
 
+#if CONFIG_IMAGES_DUP || CONFIG_IMAGES_SIM
 ######## Image signatures #######################################################
 
 ImageSig {
 
-MinWidth	16
-MinHeight	16
+# To find similar images, Sherlock uses comparison based on regions.
+# First of all, the imagesim analyser extracts various region features.
+# Sets of these features are called "image signatures" and they are stored
+# in the `H' attribute of image objects.
+
+# Signatures are later processed by the indexer to build an effective
+# search structure finally used by the search server. See Indexer and Search
+# sections for more options.
 
-PreQuantThresholds	9 20 20 20 25 25 30 30 40 40 50 50 60 60 60
+# Minimum image size to apply segmentation. Smaller images are always
+# compared by the simple "average" method (see ImageSig.CompareMethod).
+MinWidth		16
+MinHeight		16
+
+# List of subdivision thresholds in the first phase of segmentation.
+# Lower the values to increase the average number of regions and vice versa.
+PreQuantThresholds	6 12 15 20 25 25 30 30 40 40 50 50 60 60 60
+
+# Settings for the second phase of segmentation -- usually not so important.
+# We use an iterative algorithm to improve the average error from the first phase.
+# We stop the process after PostQuantMaxSteps or if we get only PostQuantThreshold
+# percentual improvement over the previous step.
 PostQuantMinSteps	2
 PostQuantMaxSteps	10
 PostQuantThreshold	1
 
+# BorderBonus and BorderSize parameters can increase or decrease the weight
+# of image pixels near the borders. Weight of all pixels more than BorderSize * MIN(cols, rows)
+# pixels far from the edges is 128. Then this value continuously decreses/increses up to 128+BorderSize.
 BorderSize		0.4
 BorderBonus		-50
 
+# Scaling constants for computation of normalized i-th order inertia features (I1, I2, I3).
 InertiaScale		2 0.5 0.05
 
+# Threshold for detecting textured images (see images/sig-txt.c for details).
+# Decrease the threshold if you want less detected textures,
+# set it to zero to disable the algorithm completely.
 TexturedThreshold	0.32
 
-# Signatures comparision method (integrated|fuzzy|average):
+# Signature comparison method:
 #
 #   integrated
-#	James Z. Wang, Jia Li and Gio Wiederhold,
+#	based on: James Z. Wang, Jia Li and Gio Wiederhold,
 #	"SIMPLIcity: Semantics-Sensitive Integrated Matching for Picture Libraries",
 #	IEEE Transactions on Pattern Analysis and Machine Intelligence, vol. 23, no. 9, pp. 947-963, 2001.
 #
-#   fuzzy
-#	Yixin Chen and James Z. Wang,
+#   fuzzy (unstable and unbalanced parameters)
+#	based on: Yixin Chen and James Z. Wang,
 #	"A Region-Based Fuzzy Feature Matching Approach to Content-Based Image Retrieval",
 #	IEEE Transactions on Pattern Analysis and Machine Intelligence, vol. 24, no. 9, pp. 1252-1267, 2002.
 #
@@ -41,14 +75,17 @@ TexturedThreshold	0.32
 #
 CompareMethod		integrated
 
-# Array of multiplicative constants in feature vectors distance computation
-# (L, u, v, LH, HL, HH, I1, I2, I3, X, Y). Each one must be in range 0..15, default is 4.
-CompareFeaturesWeights	4 8 8 4 4 4 4 4 4 4 4
+# Array of multiplicative constants in feature vector distance computation
+# (L, u, v, LH, HL, HH, I1, I2, I3, X, Y). Each one must be an integer in range 0..15, default is 4.
+CompareFeaturesWeights	4 6 6 4 4 4 4 4 4 4 4
 
 }
 
-######## Duplicates finder ######################################################
+#endif
+#ifdef CONFIG_IMAGES_DUP
+######## Duplicate finder #######################################################
 
 ImageDup {
+# Detection of image duplicates does not work yet.
 }
-
+#endif