保存为16位无符号TIFF文件失败的技术求助

• 原始图像：16位无符号TIFF（integer 2 unsigned tiff），在Paint和DigitalMicrograph(DM)中显示正常
• 处理流程：DM中处理后得到real图像，调整数值范围后用ConvertToShort()转为16位有符号图像
• 异常情况：无法生成正确的16位无符号TIFF文件；调用ImageGetOrCreateImageDocument()+ImageDocumentSaveToFile()并设置Save As Grey Scale、Include Annotation、Full Scale为1后，生成的图像在DM和Paint中显示效果差异极大

示例代码：

void my_SaveAsTiff( image tbdat, string path)
{   //  Default values for Tif:  keep actual size and burn in annotations
    number saveGreyScale = 1    // Convert to grey scale
    number includeAnno = 1      // "burn in" annotations on the display 
    number fullScale = 1        // Use data size not display-size of image
    tagGroup tg = GetPersistentTagGroup().TagGroupGetOrCreateTagGroup( "Private:Save Display" )
    tg.TagGroupSetTagAsBoolean( "Save As Grey Scale" , saveGreyScale )
    tg.TagGroupSetTagAsBoolean( "Include Annotation" , includeAnno )
    tg.TagGroupSetTagAsBoolean( "Full Scale" , fullScale )
        
    imageDocument doc = tbdat.ImageGetOrCreateImageDocument()
    doc.ImageDocumentSaveToFile( "TIFF Format", path, 1)        //  "0"... Save as shown - but full resolution (via 'includeAnno')
}   

string path = "C:/...................."

out = realImage("temp", 4, 2048, 768)   
out = 100 + 20.9*icol 
out.ConvertToShort()    //  
out.showImage()

my_SaveAsTiff( out, pathConcatenate(path, "temp"))

1. 匹配目标数据类型 #

ConvertToShort()生成的是16位有符号整数图像，而目标是16位无符号TIFF，需改用ConvertToUShort()直接将real图像转为16位无符号类型，确保数据类型对齐：

// 替换原代码中的out.ConvertToShort()
out.ConvertToUShort()

2. 调整保存参数避免显示映射干扰 #

ImageDocumentSaveToFile()第三个参数设为1时，会基于DM的显示设置（对比度、色阶映射等）保存图像，Paint无法识别这些配置导致显示异常。修改保存逻辑：

• 将第三个参数改为0，按图像原始数据保存
• 关闭标注固化，避免标注处理干扰原始数据

修改后的保存函数：

void my_SaveAsTiff( image tbdat, string path)
{   
    number saveGreyScale = 1    
    number includeAnno = 0      // 关闭标注固化，优先保证原始数据准确性
    number fullScale = 1        
    tagGroup tg = GetPersistentTagGroup().TagGroupGetOrCreateTagGroup( "Private:Save Display" )
    tg.TagGroupSetTagAsBoolean( "Save As Grey Scale" , saveGreyScale )
    tg.TagGroupSetTagAsBoolean( "Include Annotation" , includeAnno )
    tg.TagGroupSetTagAsBoolean( "Full Scale" , fullScale )
        
    imageDocument doc = tbdat.ImageGetOrCreateImageDocument()
    // 按原始数据保存，不应用DM的显示映射
    doc.ImageDocumentSaveToFile( "TIFF Format", path, 0)        
}   

3. 确保数据范围合规 #

16位无符号TIFF的有效数值范围是0~65535，转换前需将real图像数据调整至该区间，避免截断或压缩导致显示异常：

// 归一化数据到0~65535区间
out = out - min(out);
if (max(out) > 0) out = out * (65535 / max(out));
// 转换为16位无符号
out.ConvertToUShort();

4. 直接保存原始数据（可选） #

若不需要图像文档的标注等附加内容，可跳过图像文档环节，直接用SaveImage()函数保存，更可靠地保留原始数据类型：

// 替代my_SaveAsTiff的极简保存函数
void my_SaveRawTiff( image tbdat, string path)
{
    tbdat.SaveImage( path, "TIFF Format" );
}

内容的提问来源于stack exchange，提问作者E Voelkl