8 Commits

10 changed files with 99 additions and 57 deletions

View File

@@ -1,3 +1,9 @@
# 材质编辑器 # 材质编辑器
独立实现的WebCAD材质编辑器,提供材质预览,调节和上传功能。 独立实现的PBR材质编辑器,提供PBR材质预览,参数调整功能。
- 支持PBR材质的序列化输出以及反序列化输入。
- 支持多种模型的预览(球体,圆环,立方体,环面纽结,圆锥体)
- 支持PBR材质的参数调节金属度粗糙度法线强度高光强度
- 支持纹理的参数调节U/V平铺偏移缩放调节
- 支持任意程序调用可挂在于HTML元素上

View File

@@ -1,7 +1,7 @@
{ {
"name": "material-editor", "name": "material-editor",
"private": true, "private": true,
"version": "1.0.10", "version": "1.0.17",
"type": "module", "type": "module",
"scripts": { "scripts": {
"dev": "vite", "dev": "vite",

View File

@@ -168,14 +168,7 @@ export class MaterialEditor
setMaterial(mat: PhysicalMaterialRecord) setMaterial(mat: PhysicalMaterialRecord)
{ {
this.Material = mat; this.Material = mat;
// for (const child of this.ShowObject.children) {
// if (child instanceof Mesh) {
// child.material = mat.Material;
// }
// }
console.log(mat.Material);
this._MeshMaterial.copy(mat.Material); this._MeshMaterial.copy(mat.Material);
let mtl = this._MeshMaterial; let mtl = this._MeshMaterial;
if (mtl.metalness > 0.8) if (mtl.metalness > 0.8)
@@ -216,7 +209,6 @@ export class MaterialEditor
async Update() async Update()
{ {
console.log("copy:", this.Material.Material.metalness);
let mat = this.ShowMesh.material as MeshPhysicalMaterial; let mat = this.ShowMesh.material as MeshPhysicalMaterial;
mat.needsUpdate = true; mat.needsUpdate = true;

View File

@@ -1,4 +1,4 @@
import { CADFiler, CADObject, Database, DuplicateRecordCloning, Factory, LayerNode, ObjectId, PhysicalMaterialRecord } from "webcad_ue4_api"; import { CADFiler, CADObject, Database, DuplicateRecordCloning, Factory, LayerNode, ObjectId, PhysicalMaterialRecord, TextureTableRecord } from "webcad_ue4_api";
// TODO: Danger: 注意入侵性代码 // TODO: Danger: 注意入侵性代码
// 疑似是WebCAD中的漏洞当传入new Database()时, // 疑似是WebCAD中的漏洞当传入new Database()时,
@@ -23,7 +23,12 @@ export function MaterialOut(material: PhysicalMaterialRecord): string
new Map(), new Map(),
DuplicateRecordCloning.Ignore DuplicateRecordCloning.Ignore
); );
return JSON.stringify(db.FileWrite().Data); let json = JSON.stringify(db.FileWrite().Data);
// // TODO: Danger: 因为WebCAD依赖库中的部分类的构造函数名异常所以在生成JSON时需要对类名进行替换
json = json.replace(LayerNode.name, "LayerNode")
.replace(TextureTableRecord.name, "TextureTableRecord")
.replace(PhysicalMaterialRecord.name, "PhysicalMaterialRecord");
return json;
} }
export function MaterialIn(fileData: Object[]): PhysicalMaterialRecord export function MaterialIn(fileData: Object[]): PhysicalMaterialRecord

View File

@@ -7,7 +7,7 @@
<label>上传路径ID</label> <label>上传路径ID</label>
<input v-model="materialInfo.dirId" type="text" placeholder="材质路径ID" /> <input v-model="materialInfo.dirId" type="text" placeholder="材质路径ID" />
<label>配置JSON</label> <label>配置JSON</label>
<input v-model="materialInfo.inputText" type="text" /> <input v-model="materialInfo.inputText" type="text" />
<button class="btn-success" style="min-width: 110px;" @click="loadData">加载</button> <button class="btn-success" style="min-width: 110px;" @click="loadData">加载</button>
</fieldset> </fieldset>
<label>材质名</label> <label>材质名</label>
@@ -108,12 +108,13 @@
</template> </template>
<script setup lang='ts'> <script setup lang='ts'>
import { ref, reactive, watch, onMounted, computed } from "vue" import { ref, reactive, watch } from "vue"
import { useScene, type TextureAdjustment } from "../stores/sceneStore"; import { useScene, type TextureAdjustment } from "../stores/sceneStore";
import CfFlex from "./CfFlex.vue"; import CfFlex from "./CfFlex.vue";
import { DirectoryId } from "../api/Request"; import { DirectoryId } from "../api/Request";
import { IsNullOrWhitespace } from "../helpers/helper.string"; import { IsNullOrWhitespace } from "../helpers/helper.string";
import { FromDeflateBase64, ToDeflatedBase64 } from "../helpers/helper.material"; import { FromDeflateBase64, ToDeflatedBase64 } from "../helpers/helper.material";
import { storeToRefs } from "pinia";
export interface MaterialRequest { export interface MaterialRequest {
/** 材质名 */ /** 材质名 */
@@ -125,20 +126,20 @@ export interface MaterialRequest {
} }
const scene = useScene(); const scene = useScene();
const { Material, CurrGeometry, Geometries } = storeToRefs(scene);
const props = defineProps<{ const props = defineProps<{
readonly textureSrcList?: string[]; name?: string;
textureSrcList?: string[];
/** 忽略纹理参数,提交时直接输出场景内的材质,用于某些在组件外对场景进行编辑的特殊情况(例如材质编辑模式) */
ignoreTexture?: boolean;
}>(); }>();
const emits = defineEmits<{ const emits = defineEmits<{
(e: 'cancel'): void; (e: 'cancel'): void;
(e: 'submit', data: MaterialRequest[]): void; (e: 'submit', data: MaterialRequest[]): void;
}>(); }>();
const Material = computed(() => scene.Material); const debugMode = ref(true);
const CurrGeometry = computed(() => scene.CurrGeometry);
const Geometries = computed(() => scene.Geometries);
const debugMode = ref(false);
const _textureSrc = ref(props.textureSrcList); const _textureSrc = ref(props.textureSrcList);
const debugTextureSrc = ref(""); const debugTextureSrc = ref("");
const textureAdjustment = ref<TextureAdjustment>({ const textureAdjustment = ref<TextureAdjustment>({
@@ -159,14 +160,10 @@ const uploading = ref(false);
// }); // });
const materialInfo = reactive({ const materialInfo = reactive({
dirId: DirectoryId.MaterialDir, // 正常来说是2 dirId: DirectoryId.MaterialDir, // 正常来说是2
materialName: '材质', materialName: props.name || '材质',
inputText:'', inputText: '',
}); });
onMounted(() => {
scene.ChangeTextureFromUrlAsync(_textureSrc.value[0]);
})
watch(() => props.textureSrcList, async (val) => { watch(() => props.textureSrcList, async (val) => {
_textureSrc.value = val; _textureSrc.value = val;
await scene.ChangeTextureFromUrlAsync(_textureSrc.value[0]); await scene.ChangeTextureFromUrlAsync(_textureSrc.value[0]);
@@ -174,18 +171,17 @@ watch(() => props.textureSrcList, async (val) => {
watch(textureAdjustment, async (val) => { watch(textureAdjustment, async (val) => {
UpdateTexture(); UpdateTexture();
}); }, { deep: true });
// 监听纹理更新 // 监听纹理更新
watch(() => scene.CurrTexture, (val) => { watch(() => scene.CurrTexture, (val) => {
console.log('watch-CurrTexture')
textureAdjustment.value = { textureAdjustment.value = {
wrapS: val.wrapS, wrapS: val.wrapS,
wrapT: val.wrapT, wrapT: val.wrapT,
rotation: val.rotation, rotation: val.rotation,
repeatX: val.repeat.x, repeatX: val.repeat.x,
repeatY: val.repeat.y, repeatY: val.repeat.y,
moveX: val.offset.x, moveX: val.offset.x,
moveY: val.offset.y moveY: val.offset.y
} }
}) })
@@ -206,7 +202,6 @@ async function UpdateMaterial() {
} }
function UpdateTexture() { function UpdateTexture() {
console.log('UpdateTexture')
const texture = scene.CurrTexture; const texture = scene.CurrTexture;
const val = textureAdjustment.value; const val = textureAdjustment.value;
texture.wrapS = val.wrapS; texture.wrapS = val.wrapS;
@@ -221,13 +216,14 @@ function UpdateTexture() {
} }
async function loadData() { async function loadData() {
if(!materialInfo.inputText) return; if (!materialInfo.inputText) return;
const json = JSON.parse(materialInfo.inputText); const json = JSON.parse(materialInfo.inputText);
const cadFile = FromDeflateBase64(json.file); const cadFile = FromDeflateBase64(json.file);
scene.ImportMaterialAsync(cadFile) scene.ImportMaterialAsync(cadFile)
} }
async function HandleUpload() { async function HandleUpload() {
console.log(scene.GetEditor().Viewer.Scene.children);
try { try {
if (IsNullOrWhitespace(materialInfo.materialName)) { if (IsNullOrWhitespace(materialInfo.materialName)) {
alert('材质名称不可为空'); alert('材质名称不可为空');
@@ -236,18 +232,31 @@ async function HandleUpload() {
uploading.value = true; uploading.value = true;
const result = []; const result = [];
// 遍历纹理链接列表,更改纹理后将材质序列化,然后还原场景 if (props.ignoreTexture) {
let idx = 0; // 直接将材质序列化
for (const src of props.textureSrcList) {
await scene.ChangeTextureFromUrlAsync(src);
const mat = { const mat = {
name: materialInfo.materialName + ++idx, name: materialInfo.materialName,
logo: await scene.GenerateMaterialLogoAsync(), logo: await scene.GenerateMaterialLogoAsync(),
// jsonString -> Deflate -> BinaryString -> Base64 // jsonString -> Deflate -> BinaryString -> Base64
file: ToDeflatedBase64(await scene.SerializeMaterialAsync()) file: ToDeflatedBase64(await scene.SerializeMaterialAsync())
}; };
result.push(mat); result.push(mat);
} }
else {
// 遍历纹理链接列表,更改纹理后将材质序列化,然后还原场景
let idx = 0;
for (const src of _textureSrc.value) {
await scene.ChangeTextureFromUrlAsync(src);
const mat = {
name: materialInfo.materialName + ++idx,
logo: await scene.GenerateMaterialLogoAsync(),
// jsonString -> Deflate -> BinaryString -> Base64
file: ToDeflatedBase64(await scene.SerializeMaterialAsync())
};
result.push(mat);
}
}
await scene.ChangeTextureFromUrlAsync(_textureSrc.value[0]); await scene.ChangeTextureFromUrlAsync(_textureSrc.value[0]);
emits('submit', result); emits('submit', result);
return result; return result;

View File

@@ -1,7 +1,8 @@
<template> <template>
<CfFlex class="material-view"> <CfFlex class="material-view">
<div ref="container" class="material-view-container" /> <div ref="container" class="material-view-container" />
<MaterialAdjuster ref="adjuster" class="material-view-sider" :textureSrcList="textureSrc" @cancel="config.cancelCallback" @submit="config.submitCallback" /> <MaterialAdjuster ref="adjuster" class="material-view-sider" :name="matName" :textureSrcList="textureSrc" :ignore-texture="editMode"
@cancel="config.cancelCallback" @submit="config.submitCallback" />
</CfFlex> </CfFlex>
</template> </template>
<script setup lang="ts"> <script setup lang="ts">
@@ -19,9 +20,11 @@ const container = useTemplateRef('container');
const adjusterRef = useTemplateRef('adjuster'); const adjusterRef = useTemplateRef('adjuster');
const config = GetConfig(); const config = GetConfig();
const textureSrc = ref<string[]>(Array.from(config.textureSrc)); const textureSrc = ref<string[]>(Array.from(config.textureSrc));
const matName = ref<string>();
const editMode = ref(false);
// 禁用右键菜单 // 禁用右键菜单
document.addEventListener('contextmenu', (e) => e.preventDefault()); document.addEventListener('contextmenu', (e) => e.preventDefault());
onMounted(async () => { onMounted(async () => {
scene.Initial(container.value); scene.Initial(container.value);
await HandleUpdateConfig(); await HandleUpdateConfig();
@@ -46,37 +49,41 @@ function HandleChangeTexture() {
} }
async function HandleUpdateConfig() { async function HandleUpdateConfig() {
if (config.file && config.file.length > 0) { if (config.updateModel) {
console.log("base64", config.file); matName.value = config.updateModel.name;
const json = FromDeflateBase64(config.file); const json = FromDeflateBase64(config.updateModel.file);
await scene.ImportMaterialAsync(json); await scene.ImportMaterialAsync(json);
editMode.value = true;
}
else { editMode.value = false; }
if (config.textureSrc) {
textureSrc.value = Array.from(config.textureSrc);
await scene.ChangeTextureFromUrlAsync(textureSrc.value[0]);
} }
textureSrc.value = Array.from(config.textureSrc);
} }
</script> </script>
<style scoped lang="scss"> <style scoped lang="scss">
.material-view .material-view {
{ width: 100%;
width: 100cqw; height: 100%;
height: 100cqh;
box-sizing: border-box; box-sizing: border-box;
padding: 0; padding: 0;
margin: 0; margin: 0;
overflow: hidden; overflow: hidden;
&-container { &-container {
flex: 3 1; flex: 3 1;
height: 100%; height: 100%;
box-sizing: border-box; box-sizing: border-box;
overflow: hidden; overflow: hidden;
} }
&-sider { &-sider {
flex: 1 1; flex: 1 1;
overflow-y: auto; overflow-y: auto;
height: 100%; height: 100%;
box-sizing: border-box; box-sizing: border-box;
} }
} }

View File

@@ -0,0 +1,15 @@
/**
* 异步等待
* @param ms 等待毫秒数
* @param value 等待完成后返回的值
* @returns
*/
export function AsyncDelay<T>(ms: number, value?: T) {
return new Promise<T>((resolve) => setTimeout(resolve, ms, value));
}
export async function AsyncWaitUntil(predicate: () => boolean, waitTime = 100) {
while (!predicate()) {
await AsyncDelay(waitTime);
}
}

View File

@@ -20,13 +20,18 @@ export function ConfigureLibOutput(config: Partial<LibOutputConfig>) {
export type LibOutputConfig = { export type LibOutputConfig = {
/** /**
* 材质文件域名 * 材质文件域名,用来获取贴图文件
*/ */
host: string, host: string,
/** 材质贴图链接列表,场景会只会载入第一个链接作为纹理预览,但是导出提交时会为所有链接创建材质 */ /** 材质贴图链接列表,用与批量提交,场景会只会载入第一个链接作为纹理预览,但是导出提交时会为所有链接创建材质 */
textureSrc: Array<string>, textureSrc: Array<string>,
/** 材质预设数据base64编码 */ /** 更新模型,对材质进行编辑时赋值 */
file?: string, updateModel?: {
/** 材质名 */
name: string;
/** 材质预设数据base64编码 */
file: string;
}
/** 环境贴图链接(立方体贴图,按照顺序输入[右左上下前后] */ /** 环境贴图链接(立方体贴图,按照顺序输入[右左上下前后] */
envTextureSrc: string[], envTextureSrc: string[],
/** 灰度环境贴图链接,输入格式与环境贴图一致 */ /** 灰度环境贴图链接,输入格式与环境贴图一致 */

View File

@@ -1,5 +1,9 @@
import './assets/main.css' import './assets/main.css'
import { Mount } from './lib'; import { Mount } from './lib';
Mount("#app"); const app = document.createElement('div');
app.style.width = '100%';
app.style.height = '100vh';
document.body.appendChild(app);
Mount(app);

View File

@@ -75,7 +75,6 @@ const sceneSetup = () => {
} }
async function UpdateMaterialAsync() { async function UpdateMaterialAsync() {
console.log(Material.value.Update);
// TODO: Danger: 如果等待下面这一行,会导致更新卡住(未知问题) // TODO: Danger: 如果等待下面这一行,会导致更新卡住(未知问题)
Material.value.Update(); Material.value.Update();
// Material.value.Material.needsUpdate = true; // Material.value.Material.needsUpdate = true;