harfbuzz/src/hb-ot-layout-base-table.hh

510 lines
14 KiB
C++
Raw Normal View History

2017-02-18 19:54:33 +01:00
/*
2019-07-28 16:24:13 +02:00
* Copyright © 2016 Elie Roux <elie.roux@telecom-bretagne.eu>
2018-02-27 21:45:26 +01:00
* Copyright © 2018 Google, Inc.
2019-07-28 16:24:13 +02:00
* Copyright © 2018-2019 Ebrahim Byagowi
2017-02-18 19:54:33 +01:00
*
* This is part of HarfBuzz, a text shaping library.
*
* Permission is hereby granted, without written agreement and without
* license or royalty fees, to use, copy, modify, and distribute this
* software and its documentation for any purpose, provided that the
* above copyright notice and the following two paragraphs appear in
* all copies of this software.
*
* IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
* DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
* ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
* IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*
* THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
* BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
* FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
* ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
* PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
*
2018-02-27 21:45:26 +01:00
* Google Author(s): Behdad Esfahbod
2017-02-18 19:54:33 +01:00
*/
2018-02-26 10:15:08 +01:00
#ifndef HB_OT_LAYOUT_BASE_TABLE_HH
#define HB_OT_LAYOUT_BASE_TABLE_HH
2017-02-18 19:54:33 +01:00
#include "hb-open-type.hh"
#include "hb-ot-layout-common.hh"
2017-02-18 19:54:33 +01:00
namespace OT {
/*
* BASE -- Baseline
* https://docs.microsoft.com/en-us/typography/opentype/spec/base
2017-02-18 19:54:33 +01:00
*/
2018-02-27 21:45:26 +01:00
struct BaseCoordFormat1
{
hb_position_t get_coord () const { return coordinate; }
2017-02-25 20:41:05 +01:00
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this)));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
2018-02-27 21:45:26 +01:00
HBUINT16 format; /* Format identifier--format = 1 */
FWORD coordinate; /* X or Y value, in design units */
2017-02-18 19:54:33 +01:00
public:
DEFINE_SIZE_STATIC (4);
};
2018-02-27 21:45:26 +01:00
struct BaseCoordFormat2
{
hb_position_t get_coord () const
2018-02-27 21:45:26 +01:00
{
/* TODO */
return coordinate;
}
2017-02-25 20:41:05 +01:00
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
return_trace (c->check_struct (this));
}
2017-02-18 19:54:33 +01:00
protected:
2018-02-27 21:45:26 +01:00
HBUINT16 format; /* Format identifier--format = 2 */
FWORD coordinate; /* X or Y value, in design units */
HBGlyphID referenceGlyph; /* Glyph ID of control glyph */
2018-02-27 21:45:26 +01:00
HBUINT16 coordPoint; /* Index of contour point on the
* reference glyph */
2017-02-18 19:54:33 +01:00
public:
DEFINE_SIZE_STATIC (8);
};
2018-02-27 21:45:26 +01:00
struct BaseCoordFormat3
{
hb_position_t get_coord (hb_font_t *font,
const VariationStore &var_store,
hb_direction_t direction) const
2018-02-27 21:45:26 +01:00
{
2018-11-03 19:58:30 +01:00
const Device &device = this+deviceTable;
return coordinate + (HB_DIRECTION_IS_VERTICAL (direction) ?
device.get_y_delta (font, var_store) :
device.get_x_delta (font, var_store));
2018-02-27 21:45:26 +01:00
}
2017-02-25 20:41:05 +01:00
2018-11-03 19:58:30 +01:00
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this) &&
deviceTable.sanitize (c, this)));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
2018-11-03 19:58:30 +01:00
HBUINT16 format; /* Format identifier--format = 3 */
FWORD coordinate; /* X or Y value, in design units */
OffsetTo<Device>
deviceTable; /* Offset to Device table for X or
* Y value, from beginning of
* BaseCoord table (may be NULL). */
2017-02-18 19:54:33 +01:00
public:
DEFINE_SIZE_STATIC (6);
};
2018-02-27 21:45:26 +01:00
struct BaseCoord
{
bool has_data () const { return u.format; }
2019-07-30 01:04:10 +02:00
hb_position_t get_coord (hb_font_t *font,
const VariationStore &var_store,
2019-07-30 01:04:10 +02:00
hb_direction_t direction) const
2018-02-27 21:45:26 +01:00
{
switch (u.format) {
case 1: return u.format1.get_coord ();
case 2: return u.format2.get_coord ();
2018-11-03 19:58:30 +01:00
case 3: return u.format3.get_coord (font, var_store, direction);
2018-02-27 21:45:26 +01:00
default:return 0;
}
}
2017-02-25 20:41:05 +01:00
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
if (unlikely (!u.format.sanitize (c))) return_trace (false);
2018-02-27 21:45:26 +01:00
switch (u.format) {
2017-02-25 16:19:35 +01:00
case 1: return_trace (u.format1.sanitize (c));
case 2: return_trace (u.format2.sanitize (c));
case 3: return_trace (u.format3.sanitize (c));
2017-02-26 15:07:53 +01:00
default:return_trace (false);
2017-02-25 16:19:35 +01:00
}
}
2017-02-18 19:54:33 +01:00
protected:
union {
HBUINT16 format;
BaseCoordFormat1 format1;
BaseCoordFormat2 format2;
BaseCoordFormat3 format3;
2017-02-18 19:54:33 +01:00
} u;
public:
2018-02-27 21:45:26 +01:00
DEFINE_SIZE_UNION (2, format);
2017-02-18 19:54:33 +01:00
};
2018-02-27 21:45:26 +01:00
struct FeatMinMaxRecord
{
2019-07-28 16:24:13 +02:00
int cmp (hb_tag_t key) const { return tag.cmp (key); }
bool has_data () const { return tag; }
2017-02-25 20:41:05 +01:00
void get_min_max (const BaseCoord **min, const BaseCoord **max) const
2018-11-03 19:58:30 +01:00
{
if (likely (min)) *min = &(this+minCoord);
if (likely (max)) *max = &(this+maxCoord);
}
2017-02-25 20:41:05 +01:00
bool sanitize (hb_sanitize_context_t *c, const void *base) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this) &&
minCoord.sanitize (c, this) &&
maxCoord.sanitize (c, this)));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
2018-11-03 19:58:30 +01:00
Tag tag; /* 4-byte feature identification tag--must
* match feature tag in FeatureList */
OffsetTo<BaseCoord>
minCoord; /* Offset to BaseCoord table that defines
* the minimum extent value, from beginning
* of MinMax table (may be NULL) */
OffsetTo<BaseCoord>
maxCoord; /* Offset to BaseCoord table that defines
* the maximum extent value, from beginning
* of MinMax table (may be NULL) */
2017-02-18 19:54:33 +01:00
public:
DEFINE_SIZE_STATIC (8);
};
2018-02-27 21:45:26 +01:00
struct MinMax
{
void get_min_max (hb_tag_t feature_tag,
2019-07-27 23:51:54 +02:00
const BaseCoord **min,
const BaseCoord **max) const
2018-11-03 19:58:30 +01:00
{
2019-07-28 16:24:13 +02:00
const FeatMinMaxRecord &minMaxCoord = featMinMaxRecords.bsearch (feature_tag);
if (minMaxCoord.has_data ())
minMaxCoord.get_min_max (min, max);
2018-11-03 19:58:30 +01:00
else
2018-02-27 21:45:26 +01:00
{
2018-11-03 19:58:30 +01:00
if (likely (min)) *min = &(this+minCoord);
if (likely (max)) *max = &(this+maxCoord);
2017-02-26 15:07:53 +01:00
}
}
2017-02-25 20:41:05 +01:00
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this) &&
minCoord.sanitize (c, this) &&
maxCoord.sanitize (c, this) &&
featMinMaxRecords.sanitize (c, this)));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
2018-11-03 19:58:30 +01:00
OffsetTo<BaseCoord>
minCoord; /* Offset to BaseCoord table that defines
* minimum extent value, from the beginning
* of MinMax table (may be NULL) */
OffsetTo<BaseCoord>
maxCoord; /* Offset to BaseCoord table that defines
* maximum extent value, from the beginning
* of MinMax table (may be NULL) */
2018-11-15 08:48:50 +01:00
SortedArrayOf<FeatMinMaxRecord>
2018-11-03 19:58:30 +01:00
featMinMaxRecords;
/* Array of FeatMinMaxRecords, in alphabetical
* order by featureTableTag */
2017-02-18 19:54:33 +01:00
public:
2018-02-27 21:45:26 +01:00
DEFINE_SIZE_ARRAY (6, featMinMaxRecords);
2017-02-18 19:54:33 +01:00
};
2018-02-26 01:32:17 +01:00
struct BaseValues
{
const BaseCoord &get_base_coord (int baseline_tag_index) const
2017-02-26 15:07:53 +01:00
{
2018-11-03 19:58:30 +01:00
if (baseline_tag_index == -1) baseline_tag_index = defaultIndex;
return this+baseCoords[baseline_tag_index];
2017-02-26 15:07:53 +01:00
}
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this) &&
baseCoords.sanitize (c, this)));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
2018-11-03 19:58:30 +01:00
Index defaultIndex; /* Index number of default baseline for this
* script equals index position of baseline tag
* in baselineTags array of the BaseTagList */
OffsetArrayOf<BaseCoord>
baseCoords; /* Number of BaseCoord tables defined — should equal
* baseTagCount in the BaseTagList
*
* Array of offsets to BaseCoord tables, from beginning of
* BaseValues table order matches baselineTags array in
* the BaseTagList */
2017-02-18 19:54:33 +01:00
public:
DEFINE_SIZE_ARRAY (4, baseCoords);
2017-02-18 19:54:33 +01:00
};
2018-11-03 19:58:30 +01:00
struct BaseLangSysRecord
{
2019-07-28 16:24:13 +02:00
int cmp (hb_tag_t key) const { return baseLangSysTag.cmp (key); }
bool has_data () const { return baseLangSysTag; }
2017-02-25 20:41:05 +01:00
2019-07-28 18:09:20 +02:00
const MinMax &get_min_max () const { return this+minMax; }
2017-02-25 20:41:05 +01:00
bool sanitize (hb_sanitize_context_t *c, const void *base) const
2017-02-25 20:41:05 +01:00
{
2018-11-03 19:58:30 +01:00
TRACE_SANITIZE (this);
return_trace (likely (c->check_struct (this) &&
minMax.sanitize (c, this)));
2017-02-25 20:41:05 +01:00
}
2018-11-03 19:58:30 +01:00
protected:
Tag baseLangSysTag; /* 4-byte language system identification tag */
OffsetTo<MinMax>
minMax; /* Offset to MinMax table, from beginning
* of BaseScript table */
public:
DEFINE_SIZE_STATIC (6);
};
struct BaseScript
{
const MinMax &get_min_max (hb_tag_t language_tag) const
2017-02-25 20:41:05 +01:00
{
2019-07-28 16:24:13 +02:00
const BaseLangSysRecord& record = baseLangSysRecords.bsearch (language_tag);
return record.has_data () ? record.get_min_max () : this+defaultMinMax;
2017-02-25 20:41:05 +01:00
}
const BaseCoord &get_base_coord (int baseline_tag_index) const
2018-11-03 19:58:30 +01:00
{ return (this+baseValues).get_base_coord (baseline_tag_index); }
2017-02-26 15:07:53 +01:00
2019-07-28 16:24:13 +02:00
bool has_data () const { return baseValues; }
2017-02-26 15:07:53 +01:00
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this) &&
baseValues.sanitize (c, this) &&
defaultMinMax.sanitize (c, this) &&
baseLangSysRecords.sanitize (c, this)));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
2018-11-03 19:58:30 +01:00
OffsetTo<BaseValues>
baseValues; /* Offset to BaseValues table, from beginning
* of BaseScript table (may be NULL) */
OffsetTo<MinMax>
defaultMinMax; /* Offset to MinMax table, from beginning of
* BaseScript table (may be NULL) */
2018-11-15 08:48:50 +01:00
SortedArrayOf<BaseLangSysRecord>
2018-11-03 19:58:30 +01:00
baseLangSysRecords;
/* Number of BaseLangSysRecords
* defined may be zero (0) */
2017-02-18 19:54:33 +01:00
public:
2018-11-03 19:58:30 +01:00
DEFINE_SIZE_ARRAY (6, baseLangSysRecords);
2017-02-18 19:54:33 +01:00
};
2018-11-03 19:58:30 +01:00
struct BaseScriptList;
struct BaseScriptRecord
{
2019-07-28 16:24:13 +02:00
int cmp (hb_tag_t key) const { return baseScriptTag.cmp (key); }
bool has_data () const { return baseScriptTag; }
2017-02-18 19:54:33 +01:00
const BaseScript &get_base_script (const BaseScriptList *list) const
2018-11-03 19:58:30 +01:00
{ return list+baseScript; }
2017-02-25 20:41:05 +01:00
bool sanitize (hb_sanitize_context_t *c, const void *base) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this) &&
baseScript.sanitize (c, base)));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
2018-11-03 19:58:30 +01:00
Tag baseScriptTag; /* 4-byte script identification tag */
OffsetTo<BaseScript>
baseScript; /* Offset to BaseScript table, from beginning
* of BaseScriptList */
2017-02-18 19:54:33 +01:00
public:
2018-11-03 19:58:30 +01:00
DEFINE_SIZE_STATIC (6);
2017-02-18 19:54:33 +01:00
};
2018-11-03 19:58:30 +01:00
struct BaseScriptList
{
const BaseScript &get_base_script (hb_tag_t script) const
2017-02-25 20:41:05 +01:00
{
2019-07-28 16:24:13 +02:00
const BaseScriptRecord *record = &baseScriptRecords.bsearch (script);
if (!record->has_data ()) record = &baseScriptRecords.bsearch (HB_TAG ('D','F','L','T'));
2019-07-28 17:16:57 +02:00
return record->has_data () ? record->get_base_script (this) : Null (BaseScript);
2017-02-25 20:41:05 +01:00
}
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
return_trace (c->check_struct (this) &&
baseScriptRecords.sanitize (c, this));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
2018-11-15 08:48:50 +01:00
SortedArrayOf<BaseScriptRecord>
2018-11-03 19:58:30 +01:00
baseScriptRecords;
2017-02-18 19:54:33 +01:00
public:
DEFINE_SIZE_ARRAY (2, baseScriptRecords);
2017-02-18 19:54:33 +01:00
};
2017-02-25 16:34:58 +01:00
struct Axis
2017-02-18 19:54:33 +01:00
{
2019-07-30 01:04:10 +02:00
bool get_baseline (hb_tag_t baseline_tag,
hb_tag_t script_tag,
hb_tag_t language_tag,
const BaseCoord **coord) const
2017-02-26 15:07:53 +01:00
{
2018-11-03 19:58:30 +01:00
const BaseScript &base_script = (this+baseScriptList).get_base_script (script_tag);
2019-07-28 16:24:13 +02:00
if (!base_script.has_data ()) return false;
2017-02-26 15:07:53 +01:00
2019-07-28 16:24:13 +02:00
if (likely (coord))
{
unsigned int tag_index = 0;
2019-07-30 01:04:10 +02:00
(this+baseTagList).bfind (baseline_tag, &tag_index);
2019-07-28 16:24:13 +02:00
*coord = &base_script.get_base_coord (tag_index);
}
2017-02-26 15:07:53 +01:00
2018-11-03 19:58:30 +01:00
return true;
2017-02-26 15:07:53 +01:00
}
bool get_min_max (hb_tag_t script_tag,
hb_tag_t language_tag,
hb_tag_t feature_tag,
const BaseCoord **min_coord,
const BaseCoord **max_coord) const
2017-02-26 15:07:53 +01:00
{
2018-11-03 19:58:30 +01:00
const BaseScript &base_script = (this+baseScriptList).get_base_script (script_tag);
2019-07-28 16:24:13 +02:00
if (!base_script.has_data ()) return false;
2017-02-26 15:07:53 +01:00
2018-11-03 19:58:30 +01:00
base_script.get_min_max (language_tag).get_min_max (feature_tag, min_coord, max_coord);
2017-02-26 15:07:53 +01:00
2018-11-03 19:58:30 +01:00
return true;
2017-02-25 20:41:05 +01:00
}
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this) &&
(this+baseTagList).sanitize (c) &&
(this+baseScriptList).sanitize (c)));
2017-02-25 16:19:35 +01:00
}
2017-02-18 19:54:33 +01:00
protected:
OffsetTo<SortedArrayOf<Tag>>
2018-11-03 19:58:30 +01:00
baseTagList; /* Offset to BaseTagList table, from beginning
* of Axis table (may be NULL)
* Array of 4-byte baseline identification tags must
* be in alphabetical order */
OffsetTo<BaseScriptList>
baseScriptList; /* Offset to BaseScriptList table, from beginning
* of Axis table
* Array of BaseScriptRecords, in alphabetical order
* by baseScriptTag */
2017-02-18 19:54:33 +01:00
public:
DEFINE_SIZE_STATIC (4);
};
2018-02-27 21:50:57 +01:00
struct BASE
2017-02-19 10:12:22 +01:00
{
static constexpr hb_tag_t tableTag = HB_OT_TAG_BASE;
2017-02-19 10:12:22 +01:00
const Axis &get_axis (hb_direction_t direction) const
2018-11-03 19:58:30 +01:00
{ return HB_DIRECTION_IS_VERTICAL (direction) ? this+vAxis : this+hAxis; }
2017-02-26 15:07:53 +01:00
const VariationStore &get_var_store () const
2018-11-03 19:58:30 +01:00
{ return version.to_int () < 0x00010001u ? Null (VariationStore) : this+varStore; }
2017-02-26 15:07:53 +01:00
2019-07-30 01:04:10 +02:00
bool get_baseline (hb_font_t *font,
hb_tag_t baseline_tag,
hb_direction_t direction,
hb_tag_t script_tag,
hb_tag_t language_tag,
hb_position_t *base) const
2018-02-26 10:15:08 +01:00
{
2019-07-28 18:09:20 +02:00
const BaseCoord *base_coord = nullptr;
2019-07-30 01:04:10 +02:00
if (unlikely (!get_axis (direction).get_baseline (baseline_tag, script_tag, language_tag, &base_coord) ||
2019-07-28 18:16:47 +02:00
!base_coord || !base_coord->has_data ()))
2018-11-03 19:58:30 +01:00
return false;
2017-02-26 15:07:53 +01:00
2019-07-28 18:16:47 +02:00
if (likely (base))
2019-07-28 16:24:13 +02:00
*base = base_coord->get_coord (font, get_var_store (), direction);
2018-11-03 19:58:30 +01:00
return true;
2017-02-26 15:07:53 +01:00
}
2018-11-03 19:58:30 +01:00
/* TODO: Expose this separately sometime? */
bool get_min_max (hb_font_t *font,
hb_direction_t direction,
hb_tag_t script_tag,
hb_tag_t language_tag,
hb_tag_t feature_tag,
hb_position_t *min,
hb_position_t *max)
2017-02-26 15:07:53 +01:00
{
2018-11-03 19:58:30 +01:00
const BaseCoord *min_coord, *max_coord;
if (!get_axis (direction).get_min_max (script_tag, language_tag, feature_tag,
&min_coord, &max_coord))
return false;
2017-02-26 15:07:53 +01:00
2018-11-03 19:58:30 +01:00
const VariationStore &var_store = get_var_store ();
if (likely (min && min_coord)) *min = min_coord->get_coord (font, var_store, direction);
if (likely (max && max_coord)) *max = max_coord->get_coord (font, var_store, direction);
return true;
2017-02-26 15:07:53 +01:00
}
bool sanitize (hb_sanitize_context_t *c) const
2017-02-25 16:19:35 +01:00
{
TRACE_SANITIZE (this);
2018-11-03 19:58:30 +01:00
return_trace (likely (c->check_struct (this) &&
likely (version.major == 1) &&
hAxis.sanitize (c, this) &&
vAxis.sanitize (c, this) &&
(version.to_int () < 0x00010001u || varStore.sanitize (c, this))));
2017-02-25 16:19:35 +01:00
}
2017-02-19 10:12:22 +01:00
protected:
2018-11-03 19:58:30 +01:00
FixedVersion<>version; /* Version of the BASE table */
OffsetTo<Axis>hAxis; /* Offset to horizontal Axis table, from beginning
* of BASE table (may be NULL) */
OffsetTo<Axis>vAxis; /* Offset to vertical Axis table, from beginning
* of BASE table (may be NULL) */
2018-02-27 21:50:57 +01:00
LOffsetTo<VariationStore>
2018-11-03 19:58:30 +01:00
varStore; /* Offset to the table of Item Variation
* Store--from beginning of BASE
* header (may be NULL). Introduced
* in version 0x00010001. */
2017-02-18 19:54:33 +01:00
public:
2018-02-27 21:50:57 +01:00
DEFINE_SIZE_MIN (8);
2017-02-18 19:54:33 +01:00
};
} /* namespace OT */
2018-02-26 10:15:08 +01:00
#endif /* HB_OT_LAYOUT_BASE_TABLE_HH */