ImageGenerator

public final 类 ImageGenerator

根据文本提示执行图片生成。

嵌套类

类别 ImageGenerator.ConditionOptions 用于设置条件类型和插件模型的选项
类别 ImageGenerator.ImageGeneratorOptions 用于设置 ImageGenerator 的选项。 

公共方法

void
close()
关闭并清理任务运行程序。
MPImage
createConditionImage（MPImage sourceConditionImage、ImageGenerator.ConditionOptions.ConditionTypeconditionType）
根据来源映像创建具有指定条件类型的条件映像。
static ImageGenerator
createFromOptions(Context context, ImageGenerator.ImageGeneratorOptions generatorOptions)
基于 ImageGenerator.ImageGeneratorOptions 创建 ImageGenerator 实例。
static ImageGenerator
createFromOptions(Context context, ImageGenerator.ImageGeneratorOptions generatorOptions, ImageGenerator.ConditionOptions conditionOptions)
如果使用插件模型根据条件图片生成图片，则通过 ImageGenerator.ImageGeneratorOptions 和 ImageGenerator.ConditionOptions 创建 ImageGenerator 实例。
ImageGeneratorResult
execute（布尔值 showResult）
执行一次图片生成迭代。
ImageGeneratorResult
generate(String 提示、MPImage sourceConditionImage、ImageGenerator.ConditionOptions.ConditionType 条件类型, int 迭代, int Seed)
根据用于迭代的源图片和指定的随机种子生成图片。
ImageGeneratorResult
generate(String 提示, int 迭代, int 种子)
针对迭代和给定的随机种子生成图片。
void
setInputs(String 提示符、int 迭代、int 种子)
设置 ImageGenerator 的输入。
void
setInputs(String 提示、MPImage sourceConditionImage、ImageGenerator.ConditionOptions.ConditionTypeconditionType、int 迭代、int 种子)
设置 ImageGenerator 的输入。

继承的方法

公共方法

public void close ()

关闭并清理任务运行程序。

public MPImage createConditionImage (MPImage sourceConditionImage, ImageGenerator.ConditionOptions.ConditionType conditionType)

根据来源映像创建具有指定条件类型的条件映像。目前支持使用人脸特征点、深度图片和边缘图片作为条件图片。

参数
sourceConditionImage 用于创建条件图片的来源图片。
conditionType ImageGenerator.ConditionOptions.ConditionType，用于指定条件图片的类型。

public static ImageGenerator createFromOptions (Context context, ImageGenerator.ImageGeneratorOptions generatorOptions)

基于 ImageGenerator.ImageGeneratorOptions 创建 ImageGenerator 实例。

参数
context 一个 Android ERROR(/Context)。
generatorOptions 一个 ImageGenerator.ImageGeneratorOptions 实例。
抛出
如果 ImageGenerator 创建过程中出错，则会发生该错误。

public static ImageGenerator createFromOptions (Context context, ImageGenerator.ImageGeneratorOptions generatorOptions, ImageGenerator.ConditionOptions conditionOptions)

如果使用插件模型根据条件图片生成图片，则通过 ImageGenerator.ImageGeneratorOptions 和 ImageGenerator.ConditionOptions 创建 ImageGenerator 实例。

参数
context 一个 Android ERROR(/Context)。
generatorOptions 一个 ImageGenerator.ImageGeneratorOptions 实例。
conditionOptions 一个 ImageGenerator.ConditionOptions 实例。
抛出
如果 ImageGenerator 创建过程中出错，则会发生该错误。

public ImageGeneratorResult execute (boolean showResult)

执行一次图片生成迭代。必须调用 iterations 次方法来生成最终图像。必须先调用 ERROR(/setInputs)，然后才能调用此方法。

这是一个迭代 API，必须以迭代方式调用。

此 API 可用于显示中间图片生成结果和图片生成进度。请注意，请求中间结果会导致更长的延迟时间。请考虑改用 e2e API，以考虑延迟时间。

用法示例：

imageGenerator.setInputs(prompt, iters, Seed); for (int step = 0; step < iters; step++) { ImageGeneratorResult result = imageGenerator.execute(true); }

参数
showResult 是否在中间迭代中获取生成的图片结果。如果为 false，则返回 null。无论 showResult 值如何，始终在最后一次迭代时返回生成的图片结果。

public ImageGeneratorResult generate (String 提示, MPImage sourceConditionImage, ImageGenerator.ConditionOptions.ConditionTypeconditionType, int iters, int Seed)

根据用于迭代的源图片和指定的随机种子生成图片。仅在使用条件选项创建 ImageGenerator 时有效。

这是一个 e2e API，可运行 iterations 来生成图片。请考虑改用迭代 API 来获取中间结果。

参数
提示 描述要生成的图片的文本提示。
sourceConditionImage 用于创建条件图片的来源图片，可作为图片生成指南。
conditionType ImageGenerator.ConditionOptions.ConditionType，用于指定条件图片的类型。
iterations 生成图像的总迭代次数。
种子 图片生成期间使用的随机种子。

public ImageGeneratorResult generate (String 提示, int 迭代, int 种子)

针对迭代和给定的随机种子生成图片。仅在创建 ImageGenerator 时没有使用条件选项时有效。

这是一个 e2e API，可运行 iterations 来生成图片。请考虑改用迭代 API 来获取中间结果。

参数
提示 描述要生成的图片的文本提示。
iterations 生成图像的总迭代次数。
种子 图片生成期间使用的随机种子。

public void setInputs (String prompts, int iters, int Seed)

设置 ImageGenerator 的输入。ERROR(/setInputs) 和 ERROR(/execute) 方法对可供迭代使用。用户必须在 ERROR(/execute) 之前调用 ERROR(/setInputs)。仅在创建 ImageGenerator 时没有使用条件选项时有效。

参数
提示 描述要生成的图片的文本提示。
iterations 生成图像的总迭代次数。
种子 图片生成期间使用的随机种子。

public void setInputs (String 提示、MPImage sourceConditionImage, ImageGenerator.ConditionOptions.ConditionTypeconditionType, int iters, int Seed)

设置 ImageGenerator 的输入。对于迭代用法，请成对使用 ERROR(/setInputs) 和 ERROR(/execute)。用户必须在 ERROR(/execute) 之前调用 ERROR(/setInputs)。仅在使用条件选项创建 ImageGenerator 时有效。

参数
提示 描述要生成的图片的文本提示。
sourceConditionImage 用于创建条件图片的来源图片，可作为图片生成指南。
conditionType ImageGenerator.ConditionOptions.ConditionType，用于指定条件图片的类型。
iterations 生成图像的总迭代次数。
种子 图片生成期间使用的随机种子。