真实窗口

真实窗口

TrueWindow 允许兼容的家具在其玻璃区域显示实时户外景色或自定义图像。它可与启用了 TrueWindow 的 Content Patcher 包配合使用,并包含内置的山脉、海洋和夜空预设。

[center][size=6][b][i]TrueWindow[/i][/b][/size][/center]
[center][i]为支持 TrueWindow 的家具添加实时室外景观。[/i][/center]

[center][size=4][url=https://ibb.co/fYkr5gwg][img]https://i.ibb.co/0jCYS7b7/b-simple-9-2-L.png[/img][/url][/size][/center]

[b]TrueWindow [u]不是[/u] 一个自己添加新窗户的模组。[/b]

它是一个功能模组,让兼容的家具能够在玻璃区域显示室外景观。

当你把支持 TrueWindow 的家具放在室内时,玻璃部分可以显示 [b]实时室外景观[/b],让人感觉就像真的在看向窗外。

这意味着 TrueWindow 的设计目的是与添加 [b]TrueWindow 兼容家具[/b] 的模组或 Content Patcher 包配合使用。

[center]

[img]https://i.ibb.co/gZTXDm8H/image.gif[/img][/center]
[b][size=5]功能[/size][/b]

[list]
[]在兼容家具的玻璃区域显示实时室外景观
[
]让室内空间感觉像有真正的窗户通向外面
[]让你通过家具设置按地点调整视图
[
]支持多种显示来源
[]实时地点视图
[
]内置山脉图像
[]内置海洋图像
[
]内置夜空图像
[]由 Content Pack 定义的自定义图像
[
]让家具作者可以定义保留颜色、默认视图设置、是否允许右键配置,以及是否应渲染家具发光效果
[/list][center][/center]

[size=5][b]内置图像预设[/b]
[/size]
TrueWindow 还包含可作为显示来源选择的内置图像预设。

[b][center][size=3]山脉[/size][/center][/b]

[center]
[img]https://i.ibb.co/hFmRjthq/image.gif[/img][/center]

[center][b][size=3]海洋[/size][/b][/center]
[center]
[img]https://i.ibb.co/zV60r9hQ/image.gif[/img][/url][/center]

[center][size=3][b]夜空[/b][b]Sky[/b][/size][/center]
[center]
[img]https://i.ibb.co/YFj4CR8B/image.gif[/img][/url][/center]

你也可以通过 Content Pack 使用 SpecifiedImage[ 设置自己的自定义图像。
[center][/center]
[size=5][b]重要说明[/b]
[/size]
[list]
[]TrueWindow 是一个 [b]功能/框架类模组[/b],本身不是家具包
[
]目前 TrueWindow 仅支持 [b]家具[/b]
[]它目前 [b]不[/b] 支持建筑、墙壁、壁纸或直接替换地图图块
[
]要添加你自己的兼容窗户,通常需要将 TrueWindow 与 [b]Content Patcher 家具编辑/添加[/b] 配合使用
[/list][center][/center]

[size=5][b]需求[/b]
[/size]
[list]
[]SMAPI
[
]Content Patcher
[]Generic Mod Config Menu(可选)
[/list][url=https://ibb.co/fYkr5gwg][center][/center][center][/center][/url]

[b][size=6]设置
[/size][/b]

TrueWindow 有两种设置:[b]主模组设置[/b] 和 [b]家具显示设置[/b]。

[size=4][b]主设置
[/b][/size]
[list]
[
][b]RenderThrottleFrames[/b]
两次重绘之间的最小帧数。较高的值会降低重绘频率并可能提升性能。[][b]IndoorProbeIntervalTicks[/b]
当当前室内区域未找到 TrueWindow 家具时,模组重新检查的频率。[
][b]MaxRenderScale[/b]
渲染缩放的内部上限。[][b]MinEditableZoom[/b]
家具显示设置中允许的最小缩放值。[
][b]MaxEditableZoom[/b]
家具显示设置中允许的最大缩放值。[/list]

[size=4][b]家具显示设置

[img]https://i.ibb.co/C52Tt0SF/settings.png[/img]
[/b]
[/size]
右键点击支持 TrueWindow 的家具可以更改当前地点的显示设置。
这些设置会保存在存档数据中。

[list]
[][b][size=3]DisplaySource[/size][/b]
[size=3]选择家具显示的内容。[/size][/list][list]
[
][b][size=3]OffsetX[/size][/b]
[size=3]水平显示偏移。[/size][][b][size=3]OffsetY[/size][/b]
[size=3]垂直显示偏移。[/size][
][b][size=3]Zoom[/size][/b]
[size=3]室外视图或图像的缩放级别。[/size][][b][size=3]ParallaxStrength[/size][/b]
[size=3]控制视图根据玩家位置移动的强度。[/size][/list][center][/center]

[size=5][b]面向模组作者 / Content Pack 作者[/b]
[/size]
如果你想让家具兼容 TrueWindow,基本思路很简单:

[list]
[
]家具必须能被识别为 TrueWindow 目标
[]家具纹理中应显示视图的部分必须用保留颜色绘制
[/list]

TrueWindow 会检查家具的 [b]上下文标签[/b] 来判断家具是否兼容。

[size=4][b]必需标签[/b]
[/size]truewindow

[size=4][b]可选标签[/b]
[/size]truewindow_id:your_id_here

如果存在 truewindow_id,TrueWindow 会使用该 ID 查找匹配的定义。
如果不存在,则改用家具的 ItemId。


[size=5][b]玻璃区域的工作方式[/b]
[/size]
家具纹理中应像玻璃一样表现的部分必须用 [b]保留颜色[/b] 绘制。

默认保留颜色是 #FF00FF。

只有用该颜色绘制的像素才会被视为显示区域。
注意不要用保留颜色绘制边框或装饰条,除非你希望这些部分也被替换。


[size=5][b]最小设置[/b]
[/size]
最小的可能设置是:

[list]
[
]为家具添加 truewindow 标签
[]用 #FF00FF 绘制玻璃区域
[
]不需要 truewindow.json
[]不需要自定义 ID
[/list]

示例文件夹结构:

[code][CP] YourName.MinimalTrueWindow/
├─ manifest.json
├─ content.json
└─ assets/
└─ minimal_window.png[/code]
[center][/center]

[size=5][b]完整设置[/b]
[/size]
如果你想要更多控制,可以将 truewindow_id 与 truewindow.json 一起使用。

通过完整设置,你可以定义以下内容:

[list]
[
]特定的 TrueWindow 定义 ID
[]自定义保留颜色
[
]默认自定义图像
[]默认偏移
[
]默认缩放
[]视差强度
[
]是否渲染家具发光效果
[]是否允许右键配置
[/list]

示例文件夹结构:

[code][CP] YourName.FullTrueWindow/
├─ manifest.json
├─ content.json
├─ truewindow.json
└─ assets/
├─ full_window.png
└─ mountain_view.png
[/code]

示例 SpecifiedImage 设置:

[code]"SpecifiedImage": "assets/mountain_view.png"
[/code]

你可以将图像放在 Content Pack 根目录或 assets 中,但建议使用清晰的相对路径,例如 assets/filename.png。


[size=5][b]定义文件位置[/b]
[/size]
TrueWindow 可以从以下任意位置读取定义:

[list]
[
]content.json 中使用 TrueWindow 区段
[]truewindow.json
[
]assets/truewindow.json
[/list][center][/center]

[size=5][b]定义字段[/b]
[/size]
[list]
[][b]TrueWindowId[/b]
用于匹配家具定义的标识符。[
][b]ReservedColor[/b]
用于显示区域的颜色。默认为 #FF00FF。[][b]SpecifiedImage[/b]
可通过家具设置中的 [b]Specified Image[/b] 选择的自定义图像路径。[
][b]RenderLightGlows[/b]
是否应渲染家具的发光效果。[][b]ViewSettings.OffsetX[/b]
默认水平偏移。[
][b]ViewSettings.OffsetY[/b]
默认垂直偏移。[][b]ViewSettings.Zoom[/b]
默认缩放。[
][b]ViewSettings.ParallaxStrength[/b]
默认视差强度。[][b]AllowRightClickConfig[/b]
是否允许对该家具进行右键配置。[/list][center][/center]

[size=5][b]当前支持范围[/b]
[/size]
当前支持:

[list]
[
]家具:[b]支持[/b]
[/list]

当前不支持:

[list]
[]建筑
[
]墙壁图块
[]壁纸
[
]直接替换地图图块
[/list][center][/center]

[size=5][b]总结[/b]
[/size]
TrueWindow 不是自己添加窗户的模组。
它是一个为兼容家具提供 [b]窗户视图功能[/b] 的模组。

如果你想添加新窗户,请将 TrueWindow 与 Content Patcher 包或其他添加 [b]支持 TrueWindow 家具[/b] 的模组一起使用。